F The Definitive Guides 
| to the X Window System 


Volume Two 


Xlib Reference 
Manual 


for Version 11 





O’Reilly & Associates, Inc. 





Volume Two 


Xlib Reference 
Manual 


for Version I1 of the 
X Window System 


edited by Adrian Nye 


O’ Reilly & Associates, Inc. 


Copyright © 1988,1989,1990 O’ Reilly & Associates, Inc. 
All Rights Reserved 


The X Window System is a trademark of the Massachusetts Institute of Technology. 
UNIX is a registered trademark of AT&T. 


Revision and Printing History 


August 1988: First Printing. 

November 1988: Second Printing. Minor revisions. 

May 1989: Third Printing. Release 3 updates added. Minor revisions. 

April 1990: Second Edition covers Release 3 and Release 4. Major revisions. 


Small Print 


This document is based in part on Xlib—C Language X Interface, by Jim Gettys, Ron Newman, and Robert Scheifler, 
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granted, provided that the above copyright notice appears in all copies and that both that 
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distribution of the software without specific, written prior permission. MIT and Digital make 
no representations about the suitability of the software described herein for any purpose. It 
is provided ‘as is’ without expressed or implied warranty.” 


Note, however, that those portions of this document that are based on the original X11 documentation and other 
source material have been significantly revised and that all such revisions are copyright © 1987, 1988, 1989, 1990 
O’Reilly & Associates, Inc. Inasmuch as the proprietary revisions cannot be separated from the freely copyable MIT 
source material, the net result is that copying of this document is not allowed. Sorry for the doublespeak! 


While every precaution has been taken in the preparation of this book, we assume no responsibility for errors or 
omissions. Neither is any liability assumed for damages resulting from the use of the information contained herein. 
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The X Window System Series 


The books in the X Window System Series are based in part on the original MIT X Window 
System documentation, but are far more comprehensive, easy to use, and are loaded with 
examples, tutorials and helpful hints. Over 20 major computer vendors recommend or license 
volumes in the series. In short, these are the definitive guides to the X Window System. 





Volume 0: 
X Protocol Reference Manual 


A complete programmer’s reference to the X Network Protocol, the language of communi- 
cation between the X server and the X clients. 418 pages, $30.00. 


Volumes | and 2: 
Xlib Programming Manual 
Xlib Reference Manual 


Complete guide and reference to programming with the X library (Xlib), the lowest level of 
programming interface to X. 659 and 723 pages. $60.00 for the set, or $34.95 each. 


Volume 3: 
X Window System User’s Guide 


Describes window system concepts and the most common client applications available for 
X, Release 4. Includes complete explanation of the new window manager, twm, anda chapter 
on Motif. For experienced users, later chapters explain customizing the X environment. 
Useful with either Release 3 or Release 4. 586 pages. $30.00. 


Volumes 4 and 5: 

X Toolkit Intrinsics Programming Manual 

X Toolkit Intrinsics Reference Manual 

Complete guides to programming with the X Toolkit. The Programming Manual provides 
concepts and examples for using widgets and for the more complex task of writing new 


widgets. The Reference Manual provides reference pages for Xt functions, and Xt and 
Athena widgets. 582 and 545 pages. $55.00 for the set, or $30.00 each. 


Volume 7: 
X View Programming Manual 


X View is an easy-to-use toolkit that is not just for Sun developers. It is available on MIT’s 
R4 tape and System V Release 4, as well as being a part of Sun’s Open Windows package. 
This manual provides complete information on X View, from concepts to creating applica- 
tions to reference pages. 566 pages. $30.00. 
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Preface 


About This Manual 


This manual describes the X library, the C Language programming interface to Version 11 of 
the X Window System. The X library, known as Xlib, is the lowest level of programming 
interface to X. This library enables a programmer to write applications with an advanced 
user interface based on windows on the screen, with complete network transparency, that will 
run without changes on many types of workstations and personal computers. 


Xlib is powerful enough to write effective applications without additional programming tools 
and is necessary for certain tasks even in applications written with higher-level “toolkits.” 


There are a number of these toolkits for X programming, the most notable being the 
DEC/MIT toolkit Xt, the Andrew toolkit developed by IBM and Carnegie-Mellon University, 
and the InterViews toolkit from Stanford. These toolkits are still evolving, and only Xt is 
currently part of the X standard. Toolkits simplify the process of application writing con- 
siderably, providing a number of widgets that implement menus, command buttons, and other 
common features of the user interface. 


This manual does not describe Xt or any other toolkit. That is done in Volumes Four, Five, 
and Six of our X Window System series. Nonetheless, much of the material described in this 
book is helpful for understanding and using the toolkits, since the toolkits themselves are 
writter using Xlib and allow Xlib code to be intermingled with toolkit code. 


Summary of Contents 


This manual is divided into two volumes. This is the second volume, the Xlib Reference 
Manual. It includes reference pages for each of the Xlib functions (organized alphabeti- 
cally), a permuted index, and numerous appendices and quick reference aids. 


The first volume, the Xlib Programming Manual, provides a conceptual introduction to Xlib, 
including tutorial material and numerous programming examples. Arranged by task or topic, 
each chapter brings together a group of Xlib functions, describes the conceptual foundation 
they are based on, and illustrates how they are-most often used in writing applications (or, in 
the case of the last chapter, in writing window managers). Volume One is structured so as to 
be useful as a tutorial and also as a task-oriented reference. 
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Volume One and Volume Two are designed to be used together. To get the most out of the 
examples in Volume One, you will need the exact calling sequences of each function from 
Volume Two. To understand fully how to use each of the functions described in Vol- 
ume Two, all but the most experienced X “hacker” will need the explanation and examples in 
Volume One. 


Both volumes include material from the original Xlib and X11 Protocol documentation pro- | 
vided by MIT, as well as from other documents provided on the MIT release tape. We have 
done our best to incorporate all of the useful information from the MIT documentation, to 
correct references we found to be in error, to reorganize and present it in a more useful form, 
and to supplement it with conceptual material, tutorials, reference aids, and examples. In 
other words, this manual is not only a replacement but is a superset of the MIT documenta- 
tion. 


Those of you familiar with the MIT documentation will recognize that each reference page in 
Volume Two includes the detailed description of the routine found in Gettys, Newman, and 
Scheifler’s Xlib—C Language X Interface, plus, in many cases, additional text that clarifies 
ambiguities and describes the context in which the routine would be used. We have also 
added cross references to related reference pages and‘to where additional information can be 
found in Volume One. 


How to Use This Manual 


Volume Two is designed to make it as easy and fast as possible to look up virtually any fact 
about Xlib. It includes a permuted index, reference pages for each library function, appen- 
dices that cover macros, structures, function groups, events, fonts, colors, cursors, keysyms, 
and errors, and at-a-glance tables for the graphics context and window attributes. 


The permuted index is the standard UNIX way of finding a particular function name given a 
keyword. By looking up a word in the second column that you think describes the function 
you are looking for, you can find the group of functions that have that word in their descrip- 
tion lines. The description line also appears at the top of each reference page. Once you 
have found the routine you are looking for, you can look for its reference page. 


The reference pages themselves provide all the details necessary for calling each routine, 
including its arguments, returned values, definitions of the structure types of arguments and 
returned values, and the errors it may generate. Many of the pages also give hints about how 
the routine is used in the context of other routines. This is the part of this volume you will 
use the most. 


Appendix A, Function Group Summary, groups the routines according to function, and pro- 
vides brief descriptions. You’ll find it useful to have in one place a description of related 
routines, so their differences can be noted and the appropriate one chosen. 


Appendix B, Error Messages and Protocol Requests, describes the errors that Xlib routines 
can generate. When an error is handled by the default error handler, one of these messages is 
printed. Also printed is the X Protocol request that caused the error. Since Protocol requests 
do not map directly to Xlib routines, this appendix provides a table with which you can find 
out which Xlib routine in your code caused the error. 
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Appendix C, Macros, describes the macros that access members of the Display structure, 
classify keysyms, and convert resource manager types. 


Appendix D, ColorCaEE, presents the standard color database. The color names in this data- 
base should be available on all servers, though the corresponding RGB values may have been 
modified to account for screen variations. 


Appendix E, Event Reference, describes each event type and structure, in a reference page 
format. This is an invaluable reference for event programming. 


Appendix F, Structure Reference, describes all structures used by Xlib except the event struc- 
tures described in Appendix E, including which routines use each structure. 


Appendix G, Symbol Reference, lists in alphabetical order and describes all of the symbols 
defined in Xlib include files. a 


Appendix H, Keysym Reference, lists and describes each character in the standard keysym 
families, used for translating keyboard events. The characters for English and foreign lan- 
guage keysyms are shown where possible. 


Appendix I, The Cursor Font, describes the standard cursor font, including a illustration of 
the font shapes. 


Appendix J, The Xmu Library, provides reference pages for each function in the miscella- 
neous utilities library. This library is provided with the standard X distribution and is very 
useful when programming with Xlib. 


Finally, Volume Two concludes with at-a-glance charts that help in setting the graphics con- 
text (GC) and the window attributes. 


Example Programs 


The example programs in this book are on the X11 Release 4 distribution in the contributed 
section. There are many ways of getting this distribution; most are described in Appendix H. 


The example programs are also available free from UUNET (that is, free except for UUNET’s 
usual connect-time charges). If you have access to UUNET, you can retrieve the source code 
using uucp or ftp. For uucp, find a machine with direct access to UUNET and type the follow- 
ing command: 


uucp uunet\! ~uucp/nutshell/Xlib/xlibprgs.tar.Z yourhosN'"/yourname/ 


The backslashes can be omitted if you use the Bourne shell (sh) instead of csh. The file 
should appear some time later (up to a day or more) in the directory /usr/spool/uucp- 
public/yourname. 


To use ftp, ftp to uunet.uu.net and use anonymous as your user name and guest as your pass- 
word. Then type the following: 

ed /nutshell/Xlib 

binary (you must specify binary transfer for compressed files) 

get xlibprgs.tar.2Z 

bye 
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The file is a compressed shell archive. To restore the files once you have retrieved the 
archive, type: 


uncompress xlibprgs.tar 
sh xlibprgs.tar 


The example programs are also available free by ftp from expo.lcs.mit.edu. The directory 
containing the examples is contrib/examples/OReilly/Xlib . 


The examples will be installed in subdirectories under the current directory, one for each 
chapter in the book. Imakefiles are included. (Imakefiles are used with imake, a program 
supplied with the X11 distribution that generates proper Makefiles on a wide variety of sys- 
tems.) 


Assumptions 


Readers should be proficient in the C programming language, although examples are pro- 
vided for infrequently used features of the language’ that are necessary or useful when pro- 
gramming with X. In addition, general familiarity with the principles of raster graphics will 
be helpful. 


Font Conventions Used in This Manual 


Italic is used for: 


¢ UNIX pathnames, filenames, program names, user command names, and options for user 
commands. 


e New terms where they are defined. 


Typewriter Font is used for: 


¢ Anything that would be typed verbatim into code, such as examples of source code and 
text on the screen. 


¢ The contents of include files, such as structure types, structure members, symbols 
(defined constants and bit flags), and macros. 


e Xlib functions. 


¢ Names of subroutines of the example programs. 


Italic Typewriter Font is used for: 


¢ Arguments to Xlib functions, since they could be typed in code as shown but are arbi- 
trary. 


~ 
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Helvetica Italics are used for: 


¢ Titles of examples, figures, and tables. 


Boldface is used for: 


e Chapter and section headings. 


Related Documents 


The C Programming Language by B. W. Kernighan and D. M. Ritchie 
The following documents are included on the X11 source tape: 


Xt Toolkit Intrinsics by Joel McCormack, Paul Asente, and Ralph Swick 

Xt Toolkit Widgets by Ralph Swick and Terry Weissman 

Xlib—C Language X Interface by Jim Gettys, Ron Newman, and Robert Scheifler 
X Window System Protocol, Version 11 by Robert Scheifler 


The following books on the X Window System are available from O’Reilly and Associates, 
Inc.: 


Volume Zero — X Protocol Reference Manual 

Volume Three — X Window System User’ s Guide 

Volume Four — X Toolkit Intrinsics Programming Manual 

Volume Five — X Toolkit Intrinsics Reference Manual 

Volume Six — X Toolkit Widgets Reference Manual (available summer 1990) 
Volume Seven — XView Programmer’ s Guide 


Requests for Comments 


Please write to tell us about any flaws you find in this manual or how you think it could be 
improved, to help us provide you with the best documentation possible. 


Our U.S. mail address, e-mail address, and telephone number are as follows: 


O’Reilly and Associates, Inc. 
632 Petaluma Avenue 
Sebastopol, CA 95472 

(800) 338-6887 


UUCP: uunet!ora!adrian ARPA: adrian@ora.UU.NET 
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Bulk Sales Information 


This manual is being resold as the official X Window System documentation by many work- 
station manufacturers. For information on volume discounts for bulk purchase, call Linda 
Walsh at O’Reilly and Associates, Inc., at 617-354-5800, or send e-mail to linda@ora.com. 


For companies requiring extensive customization of the book, source licensing terms are also 
available. 
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Permuted Index 


How to Use the Permuted Index 


The permuted index takes the brief descriptive string from the title of each command page 
and rotates (permutes) the string so that each keyword will at one point start the second, or 
center, column of the line. The beginning and end of the original string are indicated by a 
slash when they are in other than their original position; if the string is too long, it is trun- 
cated. 


To find the command you want, simply scan down the middle of the page, looking for a key- 
word of interest on the right side of the blank gutter. Once you find the keyword you want, 
you can read (with contortions) the brief description of the command that makes up the entry. 
If things still look promising, you can look all the way over to the right for the name of the 
relevant command page. 
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for string and font metrics of a 16-bit character string /Server .........ccesssee XQueryTextExtents16 
/get string and font metrics of a 16-bit character string, locally ............000 XTextExtents16 
/get the width in pixels of a 16-bit character string, locally ...........000000 XTextWidth16 
XDrawImageString16: draw 16-bit image text characters XDrawImageString 16 
XDrawText16: draw 16-bit polytext strings ....s..cssssscessseessscessees XDrawTextl6 
/get the width in pixels of an 8-bit character string, locally ............s00s000 XTextWidth 
XDrawImageString: draw 8-bit image text Characters ..........cccecsssseees XDrawIimageString 
XDrawText: draw 8-bit polytext strings ........ssesssssesesvsesescesees XDrawText 
only XDrawString: draw an 8-bit text string, foreground ...........sscesssees XDrawString 
/disable‘or enable “access'CONtTON Secscccsseoccesesersenssnsesereccreveveveres XSetAccessControl 
XAddHost: add a host to the access control list XAddHost 
add multiple hosts to the access control list XAddHosts: ...........0000 XAddHosts 
/remove a host from the access Control list .........cssecccssssesesesecsesesers XRemoveHost 
/remove multiple hosts from the access Control List ...........scccscsssesscssesesesseneee XRemoveHosts 
deny/ XEnableAccessControl: use access control list to allow OF .........seceseseee XEnableAccessControl 
XDisableAccessControl: allow access from any NOSt «.....c.cccsssssessesesesesecere XDisableAccessControl 
/obtain a list of hosts having access to this display ..........ccscocsssssssssssesssee XListHosts 
XActivateScreenSaver: activate screen blanking ...... enestasterseretartes XActivateScreenSaver 
release the keyboard from an active grab XUngrabKeyboard: ........0+0 XUngrabKeyboard 
release the pointer from an active grab XUngrabPointer: ............sse0e0 XUngrabPointer 
/change the parameters of an active pointer grab .........csccssssssesesssesssesecaees XChangeActivePointerGrab 
pixel value in an/ XAddPixel: add a constant value to EVETY ........scceceseees XAddPixel 
list XAddHost: add a host to the access Control .......s.0e0e0e0 XAddHost 
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XInsertModifiermapEntry: 
XUnionRectWithRegion: 

a/ XrmQPutStringResource: 

a resource/ XrmPutLineResource: 
with/ XrmPutStringResource: 
save-set XAddToSaveSet: 
control list XAddHosts: 

the client’s/ XChangeSaveSet: 
XmmUniqueQuark: 

from color/ XAllocNamedColor: 
cell with closest/ XAllocColor: 
XAllocClassHint: 
XAllocIconSize: 
XAllocSizeHints: 
XAllocStandardColormap: 
XAllocWMHints: 

structure XCreateImage: 

freed Xpermalloc: 
XAllocColorPlanes: 


colorcells XAllocColorCells: 


XFree: free specified memory 
XFreeFontPath: free the memory 
XFreeFontNames: free the memory 
XFreeFontInfo: free the memory 
XFreeExtensionList: free memory 
table. /free the memory 
XDisableAccessControl: 

use access control list to 

colormap; install default if not 
XLoadFont: load a font if not 
contents of one database into 
subtract one region from 

system from one window to 

/move the pointer to 

Ansert a window between 

into a drawable with depth, 
/convert a keysym to the 

XFillArc: fill an 

XDrawAre: draw an 
XSetArcMode: set the 
XDrawArcs: draw multiple 
XFillArcs: fill multiple 

fill a rectangular 

XClearArea: clear a rectangular 
XCopy Area: copy an 

fill multiple rectangular 

database from command line 
XA_WM_COMMAND atom (command line 
properties in the properties 

/obtain RGB values for an 

flook up RGB values from 

/map a key event to 
XDefineCursor: 

the window manager XStoreName: 
/deallocate storage 

/change a property 
XDestroyImage: deallocate memory 
/the GContext (resource ID) 





add a NEW EMNLLY tO AN/ ....ererercccrervoseeroeeeeeee XInsertModifiermapEntry 
add a rectangle to a region ......0.000 XUnionRectWithRegion 
add a resource specification to XmmQPutStringResource 
add a resource specification to XmmPutLineResource 
add a resource specification ......... XrmPutStringResource 
add a window to the Client’s .......s0esc0ree XAddToSaveSet 

add multiple hosts to the access ........c0000 XAddHosts 

add or remove a subwindow from ........... XChangeSaveSet 
allocate a NEW qUATK ....cccscccrsssssscssscccsecesere XrmmUniqueQuark 
allocate a read-only Colorcell ........sc00esseee XAllocNamedColor 
allocate a read-only COlOMMaP «escscsscsesseees XAllocColor 

allocate an XClassHint structure XAllocClassHint 
allocate an XIconSize structure ........0.00000 XAllocIconSize 


allocate an XSizeHints structure XAllocSizeHints 


allocate an XStandardColommap/ 










allocate an XWMHints structure XAllocWMHints 
allocate memory for an XImMage .........000000 XCreateImage 
allocate MEMOTY NEVET tO DE ....cssscrecerereee Xpermalloc 

allocate read/WTite/ .......c.rccscscscescssssesesessees XAllocColorPlanes 
allocate read/write (nonshared) .........000000 XAllocColorCells 
allocated by an X1ib function ..........00000000 XFree 

allocated by XGetFontPath ....e.csscssessesecees XFreeFontPath 
allocated by XListFonts. .........c.cccssssccsessose XFreeFontNames 
allocated by XListFontsWithInfo ..........2.. XFreeFontInfo 
allocated for a list Off .......csccsccsssccsssscosecases XFreeExtensionList 
allocated for an assOCiatiON .......0.cccersesereee XDestroy AssocTable 


XDisableAccessControl 
XEnableAccessControl 


allow access from any host 
allow or deny connection/ 














already installed /uninstall a ........cccsccssee XUninstallColormap 
already loaded; get font ID .........esscesessees XLoadFont 

another /merge the ........-ccsscsesssssosscersseseees XrmMergeDatabases 
another XSubtractRegion: .......c-cccecscsseeee XSubtractRegion 
another /change the coordinate ..........00000 XTranslateCoordinates 
another point on the SCTEEMN ........cccesesssnseee XWarpPointer 
another window and its parent ..........ce XReparentWindow 
applying pixel values /drawable .............. XCopyPlane 
appropriate keyCOde asecsecorsscessssecnssecasseseees XKeysymToKeycode 
AUC leceansusslescsccasarentacncses foasemreente meatsees XFillArc 

arc fitting inside a rectangle ......... XDrawArc 


arc mode in a graphics context 
arcs 







arcs XFillArcs 

area XFillRectangle: .......cccccesssceses XFillRectangle 

ATEA IM A WINdOW wesssccssscerssooressecessscecessseness XClearArea 

area Of a drawable .....sess0 eacascsisasegaecesss .. XCopyArea 

areas XFillRectangles: ......sccscssssssssssseaees XFillRectangles 
arguments /load @ TESOUTCE sessscssecscsscoresees XmmParseCommand 
arguments) XSetCommand: set the .......-. XSetCommand 
array /TOtate «0.006 a keseunsqeraesocdsaeencereatsteiians XRotateWindowProperties 
array Of COLOLCELIS ......scescecseressesoesseenssesseens XQueryColors 
ASCII color name or translate/ ..... sees MParseColor 

ASCII string, keysym, and/ ssccscssscsscsssssees XLookupString 
ASSIQN & CUTSOT tO & WINdCOW aissecscsssssresneens XDefineCursor 
ASSIZN A NAME tO a WINdOW FOF .ssssececsseeee XStoreName 
associated With a TEgiON .ss.cssssseee eoreerar setae XDestroyRegion 
associated with a WindOW .essssssssssssesssseense XChangeProperty 
associated with an image sssssccscscsscscesesesees XDestroyImage 
associated with the specified/ .........cscscses XGContextFromGC 
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/the XStandardColormap structure 
string/ /free the in-memory data 
/delete an entry from an 

/free the memory allocated for an 
obtain data from an 

create an entry in an 
XCreateAssocTable: create a new 
name for a property given its 

get a font property given its 

/set the XA_WM_COMMAND 
string XIntemAtom: retum an 
XGetWindowProperty: obtain the 
/a window border pixel value 
/change a window border tile 

/set the colormap 

/set the background pixel value 
/change the background tile 

/set window 

create a window and set 

/cbtain the current 

ftum off the keyboard 

tum on the keyboard 
XPutBackEvent: push an event 
XSetState: set the foreground, 
XSetWindowBackground: set the 
XSetBackground: set the 
window /change the 
XAllowEvents: control the 
XBell: ring the 
or/ XQueryBestSize: obtain the 
XReparentWindow: insert a window 
/calculate the difference 
XDrawLine: draw a line 

XDraw: draw a polyline or curve 
/convert a key string to a 

of the/ XQueryKeymap: obtain a 
/create a pixmap with depth from 
/create a bitmap from X11 
XReadBitmapFile: read a 
XCreateBitmapFromData: create a 
XWniteBitmapFile: write a 

create a cursor from two 
graphics/ XSetFunction: set the 
activate screen 

value attribute and repaint the 
tile attribute and repaint the 
repaint the/ /change a window 
repaint the/ /change a window 
/change the 

{the window position, size, 
/remove the next event matching 
stacking order /circulate the 
/circulate the top child to the 
retum data from a cut 

from pointer motion history 

store data in a cut 

retum data from cut 
XStoreBytes: store data in cut 
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associated with the specified/ ..........ss0s0e00 XGetRGBColommaps 






associated with the specified ........ccssecee XFreeString List 
association table. ......0.00 etocbeassaaithvs divstaveen XDeleteAssoc 
ASSOCIATION table......ssecsecsssaesestorasevansesonssesees XDestroyAssocTable 
association table XLookUpAssoc: .......... XLookUpAssoc 
association table XMakeASssoc: ...s.ssesessese XMakeAssoc 
association table (X10) .......ccecscesreereresseees XCreateAssocTable 
atom XGetAtomName: get a string ......... XGetAtomName 
atom XGetFontPrope#ty: ........cvssscsseeeensece XGetFontProperty 
atom (command line arguments) XSetCommand 








atom for a given property name XIntemAtom 

atom type and property format ........s.es0 XGetWindowProperty 

attribute and repaint the border .........ss0000 XSetWindowBorder 

attribute and repaint the border ..........s.000« XSetWindowBorderPixmap 
attribute for a WindOW ......cccevesssevevsesoeves XSetWindowColormap 

attribute of a window XSetWindowBackground 
attribute Of a WINdGOW usscscsccsscsossscsesseees «ee XSetWindowBackgroundPixmap 
Altni ites eis ret eects ls ical aaraatcastcaaiboece XChange WindowAttributes 
attributes XCreateWindow: .......ccoeeesereee XCreateWindow 

























attributes Of WINdOW ...ssercccsesvssseserserersses XGetWindowAttributes 
AULO-TEpEat KEYS ceccroscssssssssescsceees ssssveesereees MAULORepeatOff 

auto-repeat keys XAutoRepeatOn: ......... XAutoRepeatOn 

back on the input queue XPutBackEvent 

background, logical function,/ ..........s0000 XSetState 

background pixel value attribute/ ............ XSetWindowBackground 
background pixel value in af ..........000sse0e XSetBackground 

background tile attribute Of a ........sssseseee XSetWindowBackgroundPixmap 
behavior of keyboard and pointer/ ........... XAllowEvents 

bell(Gonitrol} G was aeticch tetsctactectascsctssatees XBell 

"best" supported cursor, tile, XQueryBestSize 

between another window and its/ .......000+ XReparentWindow 

between the union and/ XXorRegion 

DetWEeN tWO POINIS .....c.crsererscssesssveseererenee XDrawLine 

between vertex list (from X10) .....sssseese XDraw 

binding list and a quark List ......s.ssssesseseeoee XmmStringToBinding QuarkList 
bit vector for the CUrTENL State ........seceeesee XQueryKeymap 

Potten il ata iieseeitectese ices cosstessesctebsvausbedencthes XCreatePixmapFromBitmapData 
bitmap format data iy XCreateBitmapFromData 
Bitnap froniiclisk: Sssrcsteccossseahecsaectccoseneuseees XReadBitmapFile 

bitmap from X11 bitmap format ............. XCreateBitmapFromData 
bitmap to a dile vssast5 6. carreiarometn steele XWriteBitmapFile 

bitmaps XCreatePixmapCufSsor: «sss XCreatePixmapCursor 
bitwise logical operation in a .......-.sesseeeee XSetFunction 

blanking XActivateScreenSaver: ............ XActivateScreenSaver 
border /a window border pixel .......s.s0000 XSetWindowBorder 

border /change a window border ........000.. XSetWindowBorderPixmap 
border pixel value attribute and. .........0000 XSetWindowBorder 

border tile attribute and ............000 eatin XSetWindowBorderPixmap 
border width of a window XSetWindowBorderWidth 
border width, or stacking Order ........s00000 XConfigureWindow 

both passed window and passed/ .......+.000 XCheck WindowEvent 
bottom child to the top of the XCirculateSubwindowsDown 
bottom of the stacking order XCirculateSubwindowsUp 
buffer XFetchBuffer: ..........c.cccccsscsssseseseees XFetchBuffer 

buffer /get events ........ Wa caoncse th satchossetentyeoae XGetMotionEvents 

buffer XStoreBulfers test eiestecesceseetans XStoreBuffer 

buffer 0 XFetchBytes: ....cs.ccossssccssesesssssseess XFetchBytes 
bufferOrrs.ccnas Pe Res caine XStoreBytes 


XPending: flush the request 

and/ XSync: flush the request 
XFlush: flush the request 
XRotateBuffers: rotate the cut 
XGrabButton: grab a pointer 
XUngrabButton: release a 

/get the pointer 

/set the pointer 

of a given GC from Xlib’s GC 

the union and/ XXorRegion: 

user geometry string/ XGeometry: 
/set a function 

allocate a read-only colormap 
with a window XChangeProperty: 
value/ XSetWindowBorder: 
XSetWindowBorderPixmap: 
XResizeWindow: 

context to/ XSetClipRectangles: 
XOffsetRegion: 
XSetWindowBackgroundPixmap: 
window XSetWindowBorderWidth: 
client XSetCloseDownMode: 
XRecolorCursor: 

graphics context XChangeGC: 
from one/ XTranslateCoordinates: 
XChangeKeyboardMapping: 

such as/ XChangeKeyboardControl: 
XChangeActivePointerGrab: 
XChangePointerControl: 
read/wnite/ XStoreColor: set or 
read/write/ XStoreColors: set or 

a window XMoveResizeWindow: 
siblings XRestack Windows: 
property. XSetStandardColormap: 
size, border/ XConfigureWindow: 
and font metrics of a 16-bit 

/and font metrics of a 16-bit 

the width in pixels of an 8-bit 

the width in pixels of a 16-bit 
draw 8-bit image text 

draw 16-bit image text 

matching event XCheckIfEvent: 
the event queue XEventsQueued: 
stacking/ /circulate the top 

order /circulate the bottom 
XQueryTree: retum a list of 
/circulate the stacking order of 
the/ XCirculateSubwindowsDown: 
children/ XCirculateSubwindows: 
bottom/ XCirculateSubwindowsUp: 
matches the desired depth and 

a resource value using name and 
/get a resource from name and 
window XClearArea: 
XClearWindow: 

keyboard preferences such as key 
rebind a keysym to a string for 
change the close down mode of a 


buffer and return the number of/ 







buffer and wait for all events .......... XSync 
buffer (display all queued/ ........... XFlush 
buffers XRotateBuffers 



































button XGrabButton 

button from a passive grab .........ccsccsescseees XUngrabButton 

DULtON MAPPING .........ceccceressecresssereeveeeerseoss XGetPointerMapping 
DULtON MAPPING. ......ecocecorcsorsssscscees XSetPointerMapping 

cache /obtain components ........... XGetGCValues 

calculate the difference between XXorRegion 

calculate window geometry given .......00.. XGeometry 

called after all Xlib functions ..........00000000 XSetAfterFunction 

cell with closest/ XAIlocColor: ........0.0000+ XAllocColor 

change a property associated .........-.0c0c0c0008 XChangeProperty 

change a window border pixel ..........000000 XSetWindowBorder 
change a window border tile/ XSetWindowBorderPixmap 
Change a Window’s SiZ€ ......ccssccssssessevsseseee XResizeWindow 

change clip_mask in a graphics .........0000 XSetClipRectangles 

change offset of a region ........0000000 XOffsetRegion 

change the background tile/ XSetWindowBackgroundPixmap 
change the border width of a XSetWindowBorderWidth 
change the close down mode Of a ....s:ss-+0. XSetCloseDownMode 
change the color of @ CUTSOT .........cscccsereees XRecolorCursor 

change the components of a given ........0.. XChangeGC 

change the coordinate system .........000000e0 XTranslateCoordinates 
change the keyboard mapping ..........c0000 XChangeKeyboardMapping 
change the keyboard preferences ... XChangeKeyboardControl 
change the parameters Of ann/ ..........0.s0e00e0 XChangeActivePointerGrab 
change the pointer preferences ..........ss000 XChangePointerControl 
change the RGB values Of a .........sccsesssseee XStoreColor 

change the RGB values Of ............ceseseseeee XStoreColors 

change the size and position Of ..........s0000 XMoveResize Window 
change the stacking order Of .........ccccseseses XRestack Windows 

change the standard colormap .....00cccseeee XSetStandardColormap 
change the window position, XConfigure Window 
character string /for String .........scccsceseeee XQueryTextExtents16 
character string, locally ........csssscssscsssrese XTextExtents16 

character string, locally /get ........ XTextWidth 

character string, locally /get .... XTextWidth16 

characters XDrawlmageString: ...........0+ XDrawImageString 
characters XDrawlmageString 16: .........0 XDrawlimageString 16 
check the event quetie for a ...csuccccsosseenssese XChecklfEvent 

check the number of event in ......cscscecseese XEventsQueued 

child to the bottom Of the ..cccccsssssssesesseee XCirculateSubwindowsUp 
child to the top of the stacking ...........s000 XCirculateSubwindowsDown 
children, parent, and rOOt ....ccscccocsssesnssesnees XQuery Tree 

children up or down ......00. oeaitectecsechetehtnane XCirculateSubwindows 
circulate the bottom Child to .......ssssssssseene XCirculateSubwindowsDown 
circulate the stacking order Of .......ssscssssess XCirculateSubwindows 
circulate the top child to the ........ssssscssseese XCirculateSubwindowsUp 
Class /visual information that .......sss0ssee0 XMatchVisuallInfo 

class as quarks /get ........ Revetvoncorttecsctventottes XmQGetResource 

class as strings XmmGetResource 

clear a rectangular area in a sssssssoss etvesssbrde XClearArea 

clear an entire WindOW .....00.0 Reetoasscueteneents XClearWindow 

Click /change the .........cccssrers eredivossdteteh ial XChangeKeyboardControl 
client XRebindKeysym.: ......... suave cite XRebindKeysym 

client XSetCloseDownMode: ........ssserevene XSetCloseDownMode 
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XKillClient: destroy a 

and/ XCloseDisplay: disconnect a 
XOpenDisplay: connect a 

/add a window to the 

or remove a subwindow from the 
/remove a window from the 
context XSetClipOrigin: set the 
to a/ XSetClipRectangles: change 
context to the/ XSetRegion: set 
context XSetClipMask: set 
XSetCloseDownMode: change the 
/a read-only colormap cell with 
/get database RGB values and 
/read/write colormap entry to the 
/of read/write colorcells to the 
XQueryBestCursor: get the 

obtain a description of error 

_with closest hardware-supported 
to the closest possible hardware 

a read-only colorcell from 

RGB values from 

of a read/write colorcell by 

fook up RGB values from ASCII 
XRecolorCursor: change the 
read/write (nonshareable) 

values and flags for a specified 
/set RGB values of a read/write 
/allocate a read-only 

allocate read/write (nonshared) 
RGB values for an array of 

{the RGB values of read/write 
XCreateColormap: create a 
colormap and install the default 
XInstallColormap: install a 
XFreeColormap: delete a 
XCopyColormapAndFree: copy a 
XSetWindowColormap: set the 
/allocate a read-only 
XFreeColors: free 

/the RGB values of a read/write 
/copy a colormap and return a new 
XUninstallColormap: uninstall a 
/get the standard 

/change the standard 

/get a list of installed 

to the closest possible hardware 
Aoad a resource database from 
/set the XA_WM_COMMAND atom 
/set the graphics_exposures 

/set the line drawing 

Xlib’s GC/ XGetGCValues: obtain 
context XChangeGC: change the 
to ASCII string, keysym, and 
regions XIntersectRegion: 
XUnionRegion: 

server XOpenDisplay: 
XDrawLines: draw multiple 
control list to allow or deny 
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Client Or its remMaining/ .........000ccerscersrereeers XKillClient 
client program from an X SErVer s.ccsssseseees XCloseDisplay 
client program to an X server XOpenDisplay 
CLIGTIE’S'SAVE=SEUi.schesecoscsesscssucsescsnsatoosssssseres XAddToSaveSet 





XChangeSaveSet 
XRemoveFromSaveSet 
XSetClipOngin 


client’s save-set /add 
client’s save-set 
clip origin in a graphics 


eovevces 











clip_mask in a graphics context XSetClipRectangles 
clip_mask of the graphics .......c.sscssscsessssees XSetRegion 
clip_mask pixmap in a graphics .........000000 XSetClipMask 

close down mode of a client XSetCloseDownMode 
closest hardware-supported Color .......s0+ XAllocColor 

closest hardware-supported RGB/ ........... XLookupColor 
closest possible hardware COLOT .......c..s0000 XStoreColor 

closest possible hardware colors XStoreColors 

closest supported CUFSOF SIZES «.....c.00ceceeee XQueryBestCursor 
COdE X GetError Text ..ccsecescscesesoseesscsssseses XGetErrorText 


color /a read-only colormap cell XAllocColor 





color /read/write colormap entry XStoreColor 

COlor name /allOCate ...........cccccesssssecsscessere XAllocNamedColor 
color name /hardware-supported .........000 XLookupColor 
color name /set RGB values .........c0cseceeeee XStoreNamedColor 
color name or translate/ XParseColor 













Color Of a CUTSOT .esecccoseeeeee XRecolorCursor 

Color planes /allocate ......c.sceseserersrseseseeee XAllocColorPlanes 
colorcell /obtain the RGB XQueryColor 

colorcell by color naMe ..........s00 XStoreNamedColor 
colorcell from color name XAllocNamedColor 
colorcells XAllocColorCells: ..........0ses000 XAllocColorCells 
colorcells XQueryColors: obtain .........000 XQueryColors 
colorcells to the closest .........s.c0cesescsssesees XStoreColors 
COLOTITIA Merasaecoreeseesnetseneceveseeeseetetesscactantsteee XCreateColormap 
COlormap /delete a .....ccs.sssssscccsessesesseseeees XFreeColormap 
COLONIA Pa iairarcerctseorerotesascatcbatatccteatesceed XInstallColormap 
colormap and install the default/ .............. XFreeColormap 
colormap and return a NEW/ ......0.0ccececeseeee XCopyColonnapAndFree 
colormap attribute for a window .........00+ XSetWindowColormap 
colormap cell with closest/ ......s.sssscscscesess XAllocColor 

colormap cells or planes .........00+ XFreeColors 


colormap entry to the closest/ XStoreColor 








CONG HAP ID A .ciesscccoscaceratcstorencbensvsvseanessetets XCopyColormapAndFree 
colormap; install default if not/ ..........s000 XUninstallColormap 
colormap property . XGetStandardColormap 
COLOHMAP PIOPCMY Fese..ccctasssaceseoucersscsvecssoens XSetStandardColormap 
COLOTID ADS pasaseerrenctastasrstacttessettteencerorsteneteeneD XListInstalledColormaps 
colors /of read/write colorcells ... XStoreColors 

command line arguments .........00. XmmParseCommand 
(command line arguMEnts) .........0000000cese00 XSetCommand 
component in a graphics CONTEXt ........00000 XSetGraphicsExposures 
components in a graphics CONtEXt ........000 XSetLineAttributes 
components of a given GC from ....sececssses XGetGC Values 
components of a given graphics .........00000 XChangeGC 
ComposeStatus /map a key event ........000. XLookupString 

compute the intersection Of tWO .........00000 XIntersectRegion 
compute the union ot two regions ..........0 XUnionRegion 

connect a client program to an X ........0000 XOpenDisplay 

CONNIE GEEU MINES Hiesactecesccosessvesceeesescesscoccasteces XDrawLines 

connection requests AIS ACCESS ......sece000 XEnableAccessControl 


/report the display name (when 
XNoOp: send a NoOp to exercise 
value in an/ XAddPixel: add a 
drawable into/ XGetImage: place 
XrmMergeDatabases: merge the 
components of a given graphics 
XCopyGC: copy a graphics 
context manager (not graphics 
XFreeGC: free a graphics 

with the specified graphics 

and context type (not graphics 

set the arc mode in a graphics 
pixel value in a graphics 
clip_mask pixmap in a graphics 
the clip origin in a graphics 

of line dashes in a graphics 

set the fill rule in a graphics 

set the fill style in a graphics 

the current font in a graphics 
pixel value in a graphics 

logical operation in a graphics 
component in a graphics 

drawing components in a graphics 
set the plane mask in a graphics 
and plane mask in a graphics 

set the stipple in a graphics 

the subwindow mode in a graphics 
set the fill tile in a graphics 

origin in a graphics 

a new context ID (not graphics 
and/ XDeleteContext: delete a 
XCreateGC: create a new graphics 
XUniqueContext: create a new 
XFindContext: get data from the 
/change clip_mask in a graphics 
/set clip_mask of the graphics 
/corresponding to a window and 
disable or enable access 

mapping of modifier keys (Shift, 
to be used as modifiers (Shift, 
XBell: ring the bell 

add a host to the access 

add multiple hosts to the access 
remove a host from the access 
multiple hosts from the access 
XEnableAccessControl: use access 
and pointer/ XAllowEvents: 

Xmm String ToBinding Quark List: 
list XrmStringToQuark List: 
XKeycodeToKeysym: 

akeysym XStringToKeysym: 
string XKeysymToString: 
appropriate/ XKeysymToKeycode: 
XmmQuarkToString: 

XmmString ToQuark: 

window to another /change the 
colormap/ XCopyColormapAndFree: 
XCopyGC: 























connection to a display fails) ...........c0eseee0 XDisplayName 
connection with the Server ........csecsesererees XNoOp 

constant value to Every Pixel .......cccereceee XAddPixel 

contents of a rectangle from ........ccsesseeeee XGetimage 

contents of one database into/ ..........00000 XrmMergeDatabases 
context XChangeGC: change the .........0. XChangeGC 

COME NE esasctetocstecseatsctederrscnsedenscnstticttseaserteeaes XCopyGC 

context) /get data from the .......cv..-00eeeeses XFindContext 

COMLEX tyateacceersvensesstectceressetastetsnate 

context /ID) associated .... 

context) [to a WiINdOW «cs... 

Context XSetArcMode: .......ssecccrssssserereeee XSetArcMode 

context /set the background ...........0.sese0 XSetBackground 
context XSetClipMask: set ........cccsesereee XSetClipMask 

context XSetClipOrigin: set ...........0seeeee XSetClipOngin 
CONtEXt /Set a PAttEIN .....cccrcscssrsrerersrererees XSetDashes 

context XSetFillRule: .........0-cccesesesveseesees XSetFillRule 

context XSetFillStyle: .......ccsrosesesosvseseees XSetFillStyle 

context XSetFont: set ......00 XSetFont 

context /set the foreground XSetForeground 
context /set the DitWiSe ..........ccccecersesesseeee XSetFunction 

context [the graphics_exposures ........+.0 XSetGraphicsExposures 
Context /set the LINE .....c.ccccccccsssoserererereeeee XSetLineAttributes 
context XSetPlaneMask: ........-scscscsesesseees XSetPlaneMask 
context logical fUNCtION, ..........ccccccecceeeres XSetState 

Context XSetStipple: .......cccscscecscsseassssseee XSetStipple 

context XSetSubwindowMode: set ......... XSetSubwindowMode 
GCOMPEXY EX SEU Til Cie stsrssesos scssvancerreesos coovectssd XSetTile 

context /set the tile/stipple ...........sscesseseee XSetTSOrigin 
context) XUniqueContext: create ........000 XUniqueContext 
context entry for a given Window ........000 XDeleteContext 
context for a given screen With/ .........00000 XCreateGC 

context ID (not graphics/ ........0recseeresees XUniqueContext 
context manager (not graphics/ ........+:s0000 XFindContext 

context to a list of rectangles .......ccccscesee XSetChpRectangles 
context to the specified region ........-0rse00 XSetRegion 

context type (not graphics/ ........c.ceseeereeee XSaveContext 

control XSetAccessControl: ...... -. XSetAccessControl 
Control, etc.) /obtain a ........ccreseseeesererers XGetModifierMapping 
Control, etc.) /set keycode ........ecvsssssssees XSetModifierMapping 
(Control Gn ssessvesdeveianedptaerereaess erent XBell 

control list XAUGHOSE: ......cersscesesveessccssesee XAddHost 

control list XAddHOStS: ..scsscssssesecsssesseeeees XAddHosts 

control list XKReMOveHOst: ........resesorseseeee XRemoveHost 

COnNtrOl list /TEMOVE ossccccsrorerssesssessscarscece XRemoveHosts 
control list to allow or detny/ ......c.sesoseecseee XEnableAccessControl 
control the behavior of keyboard ........0.0-. XAllowEvents 
convert a key string tO a/ ........cressccssssseesese XmmStringToBinding QuarkList 


convert a key string to a quark XmmString ToQuarkList 








convert a keycode to a keysym XKeycodeToKeysym 
convert a keysym name String tO. .......ss0000 XStringToKeysym 
convert a keysym symbol to a a... sone XKeysym ToString 
convert a keysym to the ........ Keroascnceratetcgea XKeysymToKeycode 
CONVETT a QUATK tO a SITING ..sssesossesessesereenee XrmQuarkToString 
convert a string to a quark .....s.s.0000 XmnString ToQuark 
coordinate system from one XTranslateCoordinates 
copy a colormap and return a NeW ......s00 XCopyColormapAndFree 
COPY 2 Zraphics CONLEXL ..sccorsesssesrcssreceseees XCopyGC 
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a location within/ XGetSublImage: 
drawable into a/ XCopyPlane: 
XCopyArea: 

XLookupKeysym: get the keysym 
XSaveContext: save a data value 
format/ XCreateBitmapFromData: 
XCreateColormap: 
XCreateGlyphCursor: 

standard/ XCreateFontCursor: 
XCreatePixmapCursor: 
XmmGetString Database: 
mapping/ XNewModifiermap: 
(X10) XCreateAssocTable: 
graphics/ XUniqueContext: 
XCreateRegion: 

for a given screen/ XCreateGC: 
XCreatePixmap: 
XCreatePixmapFromBitmapData: 
an image XSubImage: 

attributes XCreate Window: 
association table XMakeAssoc: 
window XCreateSimple Window: 
XGetWindowAttributes: obtain the 
context XSetFont: set the 
XGetFontPath: get the 
XGetGeometry: obtain the 
XGetInputFocus: retum the 
/obtain a list of the 
XQueryPointer: get the 
XGetPointerControl: get the 
XGetScreenSaver: get the 

/obtain a bit vector for the 
XFreeCursor: release a 

change the color of a 

a cursor from the standard 
XUndefineCursor: disassociate a 
XCreateGlyphCursor: create a 
XCreateFontCursor: create a 
XCreatePixmapCursor: create a 
get the closest supported 

/obtain the "best" supported 
XDefineCursor: assign a 

X10) XDraw: draw a polyline or 
X10) /draw a filled polygon or 
XFetchBuffer: retum data from a 
XStoreBuffer: store data in a 
XFetchBytes: retum data from 
XStoreBytes: store data in 
XRotateBuffers: rotate the 

/set a pattern of line 

a bitmap from X11 bitmap format 
a pixmap with depth from bitmap 
specified/ /free the in-memory 
XFetchBuffer: retum 
XLookUpAssoc: obtain 
XFetchBytes: retum 

(not graphics/ XFindContext: get 
XStoreBuffer: store 


Permuted Index 


copy a rectangle in drawable to 





























copy a single plane Of 2 ..........000 

copy an area of a drawable ..........0+ 

corresponding to a keycode in/ 

corresponding to a window and/ .......+.+0 XSaveContext 

create a bitmap from X11 bitmap ............ XCreateBitmapFromData 
Create a COLOMMNAP. c.srsesscoccsscsrsesesssorenesenence XCreateColormap 
create a cursor from font glyphs .........0+ XCreateGlyphCursor 
Create a CUTSOT frOM ThE ....ccssscsrerssssecncseeee XCreateFontCursor 
create a cursor from two bitmaps ........000+ XCreatePixmapCursor 
create a database from a String .......0seerssee XrmGetString Database 
create a keyboard modifier .........s.secscseseeee XNewModifiermap 
create a new association table ..........0000 XCreateAssocTable 
create a new context ID (not XUniqueContext 

CTeAate A NEW EMPLY LEGION ....secccsessesseeseees XCreateRegion 

create a new graphics CONTEXE ........cecesseeee XCreateGC 

CTEALE! AiPIXITIAP irs ossascesncsacseasseastssensconstoususten XCreatePixmap 

create a pixmap with depth from/ ............ XCreatePixmapFromBitmapData 
create a subimage from part Of ........ess0000 XSubImage 

Create a WINdOW ANd SEL ..ssccesrsorerceesseeneoese XCreateWindow 

CTEALE AN EMNETY iM AN ceecccrsssrsccsssssecncssseeseoee XMakeAssoc 

create an unmapped InputOutput ............. XCreateSimple Window 
current attributes of WindOW .........cscsesseee XGetWindowAttnbutes 
current font in a graphics .....sssssssssssessssseees XSetFont 

current font search path ......sscscssssssssssseses XGetFontPath 

current geometry of drawable XGetGeometry 

current keyboard focus window ........00+ .... XGetInputFocus 
current keyboard preferences ........s.s.ccsses XGetKeyboardControl 
CUTTENt Pointer location .........cssecssesseeerenes XQueryPointer 

current pointer preferences XGetPointerControl 
CUITeNt SCFEeN SAVEF PAaLAMELE4#S .........000000 XGetScreenSaver 
current state of the keyboard .....cccsessseese XQueryKeymap 

CUES Oli pe vehesats otencotsatanzscatoseeacanerencneansstacresdooms XFreeCursor 

CUTSOr KRecolorCursoOr: .....cecvcvcecesecssesses XRecolorCursor 

CUTSOF font /CFEALE ......cecscerereresesessscecececesees XCreateFontCursor 
CUTSOT frOM A WINDOW .resesessosssersssreerereessees XUndefineCursor 
cursor from font glyphs ......csscsssssessesessees XCreateGlyphCursor 
cursor from the standard cursor/ ........00 XCreateFontCursor 
Cursor from tWO DitMaPS ....scccsrorscssecsseseeses XCreatePixmapCursor 
cursor sizes XQueryBestCursor: .......0 XQueryBestCursor 
cursor, tile, or stipple size XQueryBestSize 

CUTSOT LO a WINdOW oesscccsoseoee r XDefineCursor 

curve between vertex list (from ........ceses00 XDraw 

curve from vertex list (fFOM ......scccccecceree XDrawFilled 

Cutebaaffe tivessessvercissscs cenchchvoosstaseesate csanttntaces XFetchBuffer 

cut buffer XStoreBuffer 

cut buffer 0 XFetchBytes 

Cut DiGhe nO wi caracecccsscsesctasssatcestncs..stotscseean . XStoreBytes 

cut buffers XRotateBuffers 

dashes in a graphics CONLEXE ..e.csecssecascesses XSetDashes 

Gate ICTCAEE ssp snaonsterbancestrantatibinss>.setedeest XCreateBitmapFromData 
Gata... CHEBIE Haveccastnessssesms caste ontshat ron. deeespieat XCreatePixmapFromBitmapData 
data associated with the .....sscscccsssrssessecees XFreeStringList 

data from a Cut buffer ........r-secssvsserssscesses XFetchBuffer 

data from an association table ..........00ce00 XLookUpAssoc 

data from cut buffer 0 ....c.scscccssscsssecessscseees XFetchBytes 

data from the context Manage ...........e0000 XFindContext 

data in a cut buffer .........000000 faruatuaadedhoasives XStoreBuffer 


XStoreBytes: store 

window and/ XSaveContext: save a 
option value from the resource 
error messages from the error 
destroy a resource 

specification to a resource 
specification into a resource 
XmmGetFileDatabase: retrieve a 
XrmGetString Database: create a 
XmmParseCommand: load a resource 
/store a resource 

/merge the contents of one 
/retum a list of 

XLookupColor: get 

/a resource specification to a 

a resource specification into a 
with an image XDestroyImage: 
with a region XDestroyRegion: 
or disable synchronization for 

a colormap and install the 

given user geometry string and 
faninstall a colormap; install 

the default/ XFreeColormap: 
given window/ XDeleteContext: 
XDeleteProperty: 

association/ XDeleteAssoc: 
XDeleteModifiermapEntry: 
access control list to allow or 
that matches the desired 

a drawable into a drawable with 
/create a pixmap with 

/for a given screen with the 
XListDepths: determine the 
XGetErrorText: obtain a 
information that matches the 
remaining/ XKillClient: 
XmmDestroy Database: 
XDestroy Window: unmap and 
window XDestroySubwindows: 
modifier/ XFreeModifiermap: 
region XPointInRegion: 

in a region XRectInRegion: 
XEmptyRegion: 

the same size,/ XEqualRegion: 
on a given screen XListDepths: 
XXorRegion: calculate the 
XSetAccessControl: 
XSynchronize: enable or 
window XUndefineCursor: 

an X server and/ XCloseDisplay: 
XDrawSegments: draw multiple 
read a bitmap from 

program from an X server and 
of hosts having access to this 
XFlush: flush the request buffer 
name (when connection to a 

a/ XDisplayName: report the 
XSetIconName: set the name to be 


data in cut buffer 0 ....... eaateeaseeerokcatestaeneets XStoreBytes 




















data value corresponding to a XSaveContext 
database /EXtract AN sescssccccsscersrees XGetDefault 

database /ObtAIN .....c.scecsscsseceseeseoressesesnseces XGetErrorDatabaseText 
database. Xcenipenceny Davabace: peenteraretes XmmDestroyDatabase 
database /add a resource XrmPutLineResource 
database /StOre @ TESOUTCE ..ccrcccscsscssscsseeeee XmmPutResource 
database from a file ..........00ecsssssssssessrsencesee XmmGetFileDatabase 
database from a String .......c.ccecssssesceseesseees XmmGetString Database 
database from command line/ ..........000000 XrmParseCommand 
database in a file ........sccscssesssssscssesessscssseees XrmPutFileDatabase 
database into ANOther ........ccccssecoesssscceseres XrmMergeDatabases 
database levels isccstissistiseedsscesssserelorssseseseees XrmQGetSearchList 
database RGB values and closest/ ........... XLookupColor 
database using a quark resource -........00+0 XmmnQPutStringResource 
database using quarks /StOTE ..........000000000 XmQPutResource 
deallocate memory associated XDestroyImage 
deallocate storage associated ....... XDestroyRegion 
debugging XSynchronize: enable ............ XSynchronize 

default colormap /delete ..........0.0000c00eeeseee8 XFreeColormap 
default geometry /geometry ........ XGeometry 

default if not already installed XUninstallColormap 
delete a colormap and install .........ss.sesse0e XFreeColormap 

delete a context entry FOF a ...c.cccscscccserersees XDeleteContext 

delete a window property .......000.. XDeleteProperty 


XDeleteAssoc 
XDeleteModifiermapEntry 
XEnableAccessControl 


delete an entry from an 
delete an entry from an/ 
deny connection requests /use .... 


depth and class /information .......... XMatchVisuallnfo 
depth, applying pixel values /of .... XCopyPlane 

depth from bitmap data. ...........csscssssssererere XCreatePixmapFromBitmapData 
depth of the specified drawable ...........00. XCreateGC 

depths available on a given/ ........000000008 XListDepths 
description Of error COdE ..ssecsssosvssssessssosees XGetErrorText 
desired depth and class /visual ..........00000 XMatchVisualInfo 
destroy a CLI|N OF IS ........reccssscesecesecssceeooes XKillClient 

destroy a resource database. ........ecceveceeeeee XmmDestroyDatabase 
destroy a window and alll/ ...........c-csssessseses XDestroyWindow 
destroy all subWindows Of  ....ccssscsscsceseeee XDestroySubwindows 
destroy and free a keyboard .......s.ssscscosseee XFreeModifiermap 
determine if a point is inside a ........ccccecesee XPointIinRegion 
determine if a rectangle resides ..........s0000 XRectInRegion 
determine if a region is EMPLY ........sscsee00 XEmptyRegion 
determine if two regions have .......ccsseseees XEqualRegion 
determine the depths available .............000 XListDepths 
difference between the union and/ ........... XXorRegion 

disable or enable access Control ......+.s.0000 XSetAccessControl 
disable synchronization fOr/ ........csceveeee XSynchronize 
disassociate a CULSOF FLOM @ osssssesssesessseeees XUndefineCursor 
disconnect a client program from. ........+00 XCloseDisplay 
Gisjoint LINES ........sssersssesseseseseees Brcresseetenastese XDrawSegments 
disk XReadBitmapFile: ......... aatesachetienetees XReadBitmapFile 
display /disconnect a Client .....ccccsscccscsesees XCloseDisplay 
display /obtain a list .......essssssscessessssesseene XListHosts 

(display all queued requests) .........csecesseene XFlush 

display fails) /the display .......ccsscosssreeees XDisplayName 
display name (when connection to ......... XDisplayName 
displayed in a WindOW’S iCOM ..essesssesscseeeee XSetIconName 
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XGetIconName: get the name to be 
next event that matches mask; 
queue that matches event type; 
passed window and passed mask; 
stacking order of children up or 
/change the close 

characters XDrawImageString 16: 
XDrawText16: 
XDrawlImageString: 
XDrawText: 

from vertex list/ XDrawFilled: 
XDrawLine: 

XDrawPoint: 

vertex list (from X10) XDraw: 
foreground only XDrawString: 
rectangle XDrawArc: 

pixmap XPutImage: 
XDrawRectangle: 

XDrawAres: 

XDrawLines: 

XDrawSegments: 

XDrawPoints: 

rectangles XDrawRectangles: 
XDrawString 16: 

XCopy Area: copy an area of a 
with the depth of the specified 
obtain the current geometry of 
depth, /copy a single plane of a 
- contents of a rectangle from 
the/ /copy a rectangle in 

/plane of a drawable into a 
XSetLineAttributes: set the line 
determine if a region is 
XCreateRegion: create a new 
XSetAccessControl: disable or 
synchronization! XSynchronize: 
generate the smallest rectangle 
XClearWindow: clear an 
XDeleteContext: delete a context 
XDeleteAssoc: delete an 
structure /delete an 
XMakeAssoc: create an 
structure /add a new 

/values of a read/write colormap 
obtain a description of 

/obtain error messages from the 
XSetErrorHandler: set a nonfatal 
XGeiErrorDatabaseText: obtain 
/and wait for all events and 
modifier keys (Shift, Control, 

as modifiers (Shift, Control, 

the event queue for a matching 
XSendEvent: send an 
XPutBackEvent: push an 

set a nonfatal error 

window /retum the next 

-event type;/ /retum the next 
procedure/ XPeeklfEvent: get an 


Parmbied Index 




















displayed in aN ICOM ......c.sscececessecnceseeeseeees XGetIconName 

don’t wait /remove the XCheckMaskEvent 
don’t wait /the next EVENt IN ......cscecssere XCheckTypedEvent 
don’t wait /event matching both ........s.000 XCheck WindowEvent 
down /circulate the .........-0scccesssersrseeseenees XCirculateSubwindows 
down mode of a Client .........sessssssssererseeeeees XSetCloseDownMode 
draw 16-bit Image text ......c.cceserecsreeesenseee XDrawImageString 16 
draw 16-bit polytext Strings .........sec0eeeeeee XDrawTextl6 

draw 8-bit image text characters .........0008 XDrawImageString 
draw 8-bit polytext Strings .......ccccccsreeeseene XDrawText 

draw a filled polygon OF CUIVE ..........cc0000 XDrawFilled 

draw a line between two POINts ........se0eree XDrawLine 

APA WHA POH Oe a sscstecsetbecestorscctereseelotocansoterss XDrawPoint 

draw a polyline or curve between .......0..+ XDraw 

draw an 8-bit text String, .......ccsceseserseereee XDrawString 

draw an arc fitting inside a .......c.s.cecesseeeee XDrawArc 

draw an image ON a WINdOW OF «eessseeesereee XPutimage 

draw an outline of a rectangle ....... .... XDrawRectangle 

draw multiple arcs ........000cccscsserseeee «oe XDrawArcs 

draw multiple connected lines. ...... ... XDrawLines 

draw multiple disjoint lines ........... .». X DrawSegments 

draw multiple Points. .......sssscsssessesscsesseees XDrawPoints 

draw the outlines of multiple ...........0000000¢ XDrawRectangles 

draw two-byte text Strings ........006 we X Drawstring 16 
ATAWADIE? iicttrcscssssccsossestensnsnessuceacoeus ««. XCopyArea 

drawable /fora given screen ......... «.. XCreateGC 

drawable XGetGeometry: .......0000 «.. XGetGeometry 
drawable into a drawable with ...... «ee XCopyPlane 

drawable into an image /place ...... -... XGetimage 

drawable to a location Within ..........0sse000 XGetSubImage 
drawable with depth, applying/ ............00. XCopyPlane 

drawing components in a graphics/ ......... XSetLineAttributes 
empty XEmMptyREZion: .......0ceccsscsceceeeesees XEmptyRegion 

EMPL {TE BIOTIN sacsscsavobseetachtectoveceeceeccensacovanese XCreateRegion 

enable access control XSetAccessControl 
enable wr Gisablemeriatssckotacessacstesesteecedeetensts XSynchronize 
enclosing a region XCIipBoXx: .........000s000 XClipBox 

entire window ....... Rsithessesbesreesetobsnttasstecchehe XClearWindow 

entry for a given window and/ ..........c0s000 XDeleteContext 

entry from an association table. ..........000 XDeleteAssoc 

entry from an XModifierKeymap ............ XDeleteModifiermapEntry 
entry in an association table ..........sesesseee XMakeAssoc 

entry to an XModifierKeymap. .........s00000 XInsertModifiermapEntry 
entry to the closest possible/ ..........ssssesesee XStoreColor 

error Code XGetErrorText: ......cosssssssssseeees XGetErrorText 
@MTOMAALAD ASE etescetecasasceeresesnscccvecebrossostvteres XGetErrorDatabaseText 
ELTOMEVENWHAN IEE corevecetzecstntscsonteeuceovtuvere XSetErrorHandler 
error messages from the €rfOr/ .........00000e XGetErrorDatabaseText 
errors to be processed by the/ ........sssseeee XSync 

etc.) /obtain a mapping Of ..........csesssseseeee XGetModifierMapping 
etc.) /set keycodes to be used .........000000000 XSetModifierMapping 
event XCheckIfEvent: check ........s-ssss0ee0 XCheckIfEvent 

VERA tts vera rtoac acters tates chacssensnetcecetzeestee ... XSendEvent 

event back on the input queue XPutBackEvent 

event handler XSetErrorHandler: ............ XSetErrorHandler 
event in queue matching type and ........... XCheckTypedWindowEvent 
event in queue that matches. .........s.seseee XCheckTypedEvent 
event matched by predicate ....c..csesesseseeee XPeeklfEvent 


procedure XIfEvent: wait for 
window and/ /remove the next 
XNextEvent: get the next 

the number of events in the 
XChecklIfEvent: check the 
XMaskEvent: remove the next 
XCheckMaskEvent: remove the next 
XWindowEvent: remove the next 
and/ XLookupString: map a key 
next event in queue that matches 
window XSelectInput: select the 
the queue XPeekEvent: get an 
the number of pending input 
request buffer and wait for all 
history/ XGetMotionEvents: get 
/check the number of 

/behavior of keyboard and pointer 
server XNoOp: send a NoOp to 
XShrinkRegion: reduce or 
XQueryExtension: get 

for a list of installed 

Xlib and/ /retum a list of all 
resource database XGetDefault: 
(when connection to a display 
XQueryBestTile: obtain the 
XQueryBestStipple: obtain the 
retrieve a database from a 

store a resource database in a 
write a bitmap to a 
XFillPolygon: 

XFillRectangle: 

XFillArc: 

XLoadQueryFont: load a font and 
XFillArcs: 

XFillRectangles: 

XSetFillRule: set the 
XSetFillStyle: set the 

XSetTile: set the 

obtain the fastest supported 
vertex list/ XDrawFilled: draw a 
structures that/ XGetVisuallnfo: 
XDrawArec: draw an arc 

/obtain the RGB values and 
retum the number of/ XPending: 
wait for all events and/ XSync: 
(display all queued/ XFlush: 
retum the current keyboard 
XSetInputFocus: set the keyboard 
cursor from the standard cursor 
information about a loaded 
XUnloadFont: unload a 
XLoadQueryFont: load a 

font/ XFreeFont: unload a 
create a cursor from 

font if not already loaded; get 
font ID XLoadFont: load a 
XSetFont: set the current 

query the server for string and 
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event matched in predicate .........00-00csesree XIfEvent 
event matching both passed .......s.0e0 sseseese & Check WindowEvent 











event of any type OF WINdOW ....ssssssereeveee XNextEvent 

event queue /ChECK .......ccccseee seeanetaceessoertsba XEventsQueued 
event queue for a matching eVENt ......0000 XChecklfEvent 
event that matches mask ....... Gesonatecssvovesties XMaskEvent 

event that matches mask; don’t ........cceseee XCheckMaskEvent 
event that matches the specified/ ........... XWindowEvent 
event to ASCII string, keysym, .......ss-00000 XLookupString 
event type; don’t wait /the ........ watbinastiveis XCheckTypedEvent 
EVENL LYPES LO bE SENE LO A sascrcccccssscoosesoonres XSelectInput 

event without removing it from ........0.00000 XPeekEvent 


events /buffer and return 
events and errors to be/ /the 
events from pointer motion 








events in the Event QUEUE .....cecereseee see XEVentsQueued 
events when these resources are/ .......s0000 XAllowEvents 
exercise Connection With the ........r0.00-000000 XNoOp 

expand the size Of a FEgQiON .......00recscerereee .. XShrinkRegion 
EXtension InfOrMAtiON ..........000ecerssvcsseeerees XQueryExtension 
extensions /memory allocated ..........0000e XFreeExtensionList 
extensions to X supported by .........0c0eeeee XListExtensions 
extract an option value from the .........0000 XGetDefault 

fails) /report the display name ............0000 XDisplayName 
fastest supported fill tile/ ............sscssssesseces XQueryBestTile 
fastest supported stipple shape .......... sseeeee & Query BestStipple 
file XrmGetFileDatabase: .........cesccceoseese XrmGetFileDatabase 
file XrmPutFileDatabase: ............cccseseeesee XmmPutFileDatabase 
file XWniteBitmapFile: ...........cecessssesssseeee XWriteBitmapFile 
fill a polygon .......000 saeastscastcaceuusactscestenstors XFillPolygon 

fill a rectangular area .........ccscccsssssesssesseeee XFillRectangle 

fill aN ATC .....cesscee0e saswostatanedatttatstteesrsonsepatet XFillArc 

fill information StrUCtUTe .......00secerseceresseee XLoadQueryFont 
fill multiple arcs .......c0resssscscseeses eeiaaasaeneneese XFillArcs 

fill multiple rectangular areas 


fill rule in a graphics context 
fill style in a graphics CONTEXt ........0.0000s0ee XSetFillStyle 










fill tile in a graphics CONLEXE ...eccccrerscsseesese XSerTile 

fill tile shape XQueryBestTile: ...........0000 XQueryBestTile 
filled polygon OF CUTVE fFOM ..scccesscosessceees XDrawFilled 

find the visual information ..........00000000 +. XGet VisuallInfo 
fitting inside a rectangle .........0000 easesushesneay XDrawAre 

flags for a specified Colorcell .....ssecseseeese XQueryColor 
flush the request buffer and .........0ccesssvee XPending 

flush the request buffer and ....... iseassastvaare NO YNC 

flush the request buffer .......ccsssessssssseesseee XFlush 

focus window XGetInputFocus: ........+.000 XGetInputFocus 
FOCUS WINdOW ecssscsssssssesecesssessees Peovveanteahanee XSetInputFocus 
font /Create a ......0.000 aWeapltscevedi Getsbeasacsapnakaees XCreateFontCursor 
font XQueryFont: returm ...cccscesecsececsesees XQueryFont 
font Tees eadesteddausvvastdnebestalDoctedssoanna XUnloadFont 
font and fill information/ .........c.sc0s0ceceeee XLoadQueryFont 
font and free storage for the c..ssssssscsseeeee XFreeFont 


font glyphs XCreateGlyphCursor;: .......... XCreateGlyphCursor 
font ID XLoadFont: load a ....sscsssssssoeseeee XLoadFont 

font if not already loaded; get ........sssssseee XLoadFont 

font in a graphics CONLEXt ....ccccsecssscrsceseeees XSetFont 

font metrics XQueryTextExtents: ......... +. XQueryTextExtents 





eeccceee 
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XTextExtents: get string and 
/query the server for string and 
XTextExtents16: get string and 

retum a list of the available 
XGetFontProperty: get a 
XGetFontPath: get the current 
XSetFontPath: set the 

a font and free storage for the 
and information about loaded 
function,/ XSetState: set the 
draw an 8-bit text string, 
XSetForeground: set the 

/create a bitmap from X11 bitmap 
the atom type and property 
/obtain the supported pixmap 
XFreeGC: 

XFreeModifiermap: destroy and 
XFreePixmap: 

XFreeColors: 

of/ XFreeExtensionList: 

by an Xlib function XFree: 
XFreeFont: unload a font and 
associated/ XFreeString List: 
XGetFontPath XFreeFontPath: 
XListFonts. XFreeFontNames: 
XFreeFontInfo: 

association/ XDestroyAssocTable: 
allocate memory never to be 
memory allocated by an Xlib 
/foreground, background, logical 
XSetA fterFunction: set a 

a function called after all Xlib 
XBell: ring the bell (Control 

of a given GC from Xlib’s 
/obtain components of a given 
XGContextFromGC: obtain the 
XPolygonRegion: 

standard window/ XParseGeometry: 
enclosing a region XClipBox: 
user geometry string and default 
XGeometry: calculate window 
XWMGeometry: obtain a window’s 
XGetGeometry: obtain the current 
and size from standard window 
/window geometry given user 
atom XGetFontProperty: 
XListInstalledColormaps: 

class as/ XrmGetResource: 

and class as/ XrmQGetResource: 
given its atom XGetAtomName: 
property) XFetchName: 
predicate/ XPeekIfEvent: 

from the queue XPeekEvent: 
manager (not/ XFindContext: 
closest/ XLookupColor: 

history/ XGetMotionEvents: 
XQueryExtension: 

a font if not already loaded; 
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font metrics locally ........cscssssscsersssesessesceees XTextExtents 

font metrics of a 16-bit/ .........0. eons XQuery TextExtents 16 
font metrics Of & 16-Dit/ .........00ececrsssseeesee XTextExtents16 
font names XListFonts: ..........-0scesscersseesees XListFonts 

font property given its AtOM «....cczcccseeeeees XGetFontProperty 
font search path ........ psasedteasbnteciphavssssamoesee XGetFontPath 

font search pathy cses. cits: ccvsnessatstacsecessseassneenst XSetFontPath 

font structure AUnlOad .........0cecsreeeseeeeeese XFreeFont 

fonts /obtain the nNaMes ........sseescssesees XListFonts WithInfo 
foreground, background, logical sone KOCLOLALE 
foreground only XDrawString: .........00000 XDrawString 
foreground pixel value in a/ .......cccececeeeee XSetForeground 










eeccccecoccs: 


evece, 








format. data je.t,.cccesccatssvascececsctves agesaaeseseeeneeed XCreateBitmapFromData 
format for a Window /obtaiN .........0.0sere00 XGetWindowProperty 
formats for a ZiVEN SEIVE ..csesescesccsceseeseee XListPixmapFormats 
free a graphics CONIEKE ....c.cccscersesssecsseseesees XFreeGC 

free a keyboard modifier mapping/.......... XFreeModifiermap 
free a pixMap ID ...rsecssccccccscssscceressoeserorereee XFreePixmap 

free colormap cells or planes ............0000000e XFreeColors 

free memory allocated for a list ...........0000 XFreeExtensionList 
free specified memory allocated ..........0 XFree 

free storage for the font/ ..........000esececceeesere XFreeFont 

free the in-MeEMOTY data ...........cccecsrseserseres XFreeStringList 

free the memory allocated by ...........000008 XFreeFontPath 

free the memory allocated by .........see000 XFreeFontNames 
free the memory allocated by/ «........0ss0000 XFreeFontinfo 

free the memory allocated for an ..........00 XDestroyAssocTable 
freeduXpenmiallocniccctrssctccstetascaesneterioy Xpermalloc 

function XFree: free specified .........c00000 XFree 

function, and plane mask in a/ .........00000008 XSetState 

function called after all Xib/ ...........0000e000 XSetAfterFunction 
functions /set 

G) ea Msrstentecres surerapenttccaattceleesssetagecnascsectaeceiet 

GC cache /obtain component .........0.0000+ XGetGCValues 

GC from X1ib’s GC Cache ....sessssesssecssseeees XGetGCValues 
GContext (resource ID)/ XGContextFromGC 
generate a region from POINtS ........c0ererseee XPolygonRegion 
generate position and size from ........esse00 XParseGeometry 
generate the smallest rectangle .............000 XClipBox 

geometry /window geometry given ......... XGeometry 
geometry given user ZEOMELTY/ .......0ecereeee XGeometry 
BEOMEtrY InfOMMAation ....scrscsvssosersreesscerees XWMGeometry 


geometry of drawable ........ssse00 basa 
geometry string /position ........ 


Be XGetGeometry 
oe XParseGeometry 






geometry string and defaullt/ ............0scseee XGeometry 

get a font property given its ........ Posaeendteeeds XGetFontProperty 

get a list of installed/ .........rcscscsssssesessssers XListInstalledColormaps 
get a resource from name and ......... XmmnGetResource 


get a resource value using name XrmQGetResource 
get a string name for a property XGetAtomName 
get a window’s name (KA_WM_NAME. XFetchName 








get an event matched by .........scccssscsescecsees XPeeklfEvent 

get an event without removing it XPeekEvent 

get data from the COMTEX .....ccccccssssesseseesees XFindContext 

get database RGB values and ........ sanevebane XLookupColor 

get events from pointer MOTION .........sec000 XGetMotionEvents 
get extension information ...........cccsceesees XQueryExtension 
get font ID XLoadFont: load .............00000 XLoadFont 
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XGetlconSizes: 

locally XTextExtents: 

16-bit/ XTextExtents 16: 

sizes XQueryBestCursor: 
XGetFontPath: 

XQueryPointer: 

preferences XGetPointerControl: 
parameters XGetScreenSaver: 

a keycode in/ XLookupKeysym: 
an icon XGetIconName: 

or window XNextEvent: 
XGetPointerMapping: 

window XListProperties: 
window in/ XGetNormalHints: 
property XGetStandardColormap: 
16-bit character/ XTextWidth16: 
- 8-bit character/ XTextWidth: 

a window XGetClassHint: 
property/ XGetTransientForHint: 
create a cursor from font 
parameters of an active pointer 
release a button from a passive 
release a key from a passive 

the keyboard from an active 

the pointer from an active 

release the server from 
XGrabKey: 

XGrabButton: 

XGrabKeyboard: 

XGrabPointer: 

XGrabServer: 

events when these resources are 
change the components of a given 
XCopyGC: copy a 

from the context manager (not 
XFreeGC: free a 

associated with the specified 

a window and context type (not 
set the arc mode in a 

the background pixel value in a 
set clip_mask pixmap in a 

/set the clip origin in a 

a pattern of line dashes in a 

set the fill rule in a 

set the fill style in a 

set the current font in a 

the foreground pixel value in a 
bitwise logical operation in a 
/component in a 

the line drawing components in a 
set the plane mask in a 

function, and plane mask in a 

set the stipple in a 

/set the subwindow mode in a 
XSetTile: set the fill tile in a 

set the tile/stipple origin in a 
/create a new context ID (not 
screen/ XCreateGC: create a new 
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get preferred icOMN SIZES ....csssocsrsresesresseees .» XGetIconSizes 


get string and font MEtriCs ......-.00eeeeeeeees . XTextExtents 

get string and font metrics Of 2 ........0.000000 XTextExtents16 

get the closest supported CUFSOF ........0e0000 XQueryBestCursor 
get the current font search path .........s00000 XGetFontPath 

get the current pointer location .........000008 XQueryPointer 

get the CUFTENE POINTE ..........cccereresveee sssseee X GetPointerControl 
get the CUITeNE SCTEEN SAVET .....ceresseveeeveeee XGetScreenSaver 
get the keysym corresponding to .........000 XLookupKeysym 
get the name to be displayed in ..........00000 XGetIconName 

get the next event of any type .......ccseseeee XNextEvent 

get the pointer button mapping ...........000 XGetPointerMapping 
get the property list fOr a ....sccsscccsssssesseseeers XListProperties 

get the size hints property Of a ........cece0ee XGetNormalHints 


get the standard colormap XGetStandardColormap 





get the width in pixels of a XTextWidth16 

get the width in pixels Of an ........seseseesee XTextWidth 

get the XA_WM_CLASS property of ..... XGetClassHint 

get the XA_WM_TRANSIENT_FOR ..... XGetTransientForHint 
glyphs XCreateGlyphCursor: ........0.000e0008 XCreateGlyphCursor 

grab /change the......... reractdenstaseetcesccsenereees XChangeActivePointerGrab 





grab XUngrabButton: .......00 XUngrabButton 
grab XUngrabKey sicsisscsessscsssarssscecassesosescs XUngrabKey 















grab XUngrabKeyboard: release ..........0. XUngrabKeyboard 
grab XUngrabPointer: release ........000000 XUngrabPointer 
grab XUngrabServer: ......csscccssscscsecsseeese XUngrabServer 
grab a key .....ssseseese ctebetverserise XGrabKey 

grab a pointer button XGrabButton 

grab the keyboard XGrabKeyboard 
grab the pointer ...... XGrabPointer 
grab the server ........ XGrabServer 
grabbed /of keyboard and pointer ........... XAllowEvents 
“graphics context XChangeGC: esee.scccssssese XChangeGC 
Braphics CONLEXE ...ecccosees Renata nieereere tessestes XCopyGC 
graphics context) /get data .......--.rscsrssesese XFindContext 
Graphics! CONLEXDI2..d.-sscsceccsercvecactastosctvectesss XFreeGC 

graphics context /(resource ID) .........000 XGContextFromGC 
Graphics:COntext):/tO/ siessccocscacecorevsseossuasacsid XSaveContext 
graphics context XSetArcMode: ........0000 XSetArcMode 
Praphics conte xts/Selisescsctacractebeasessctossvente XSetBackground 
graphics context XSetClipMask: .........000 XSetClipMask 
graphics context XSetClipOrigin 
graphics context /set ....... ancsindectiaecosteyee «6 XSetDashes 


graphics context XSetFillRule: «cesses XSetFillRule 
graphics context XSetFillStyle: .......s00 XSetFillStyle 








graphics context XSetFont: ....sccccsssesseees XSetFont 

graphics context /set ........0000 XSetForeground 
graphics context /set the XSetFunction 
graphics CONEEX ......csseseeee feesdaecontiss onetseent XSetGraphicsExposures 
graphics Context /Set s..s..scsseeseees Perecssbeeetose XSetLineAttributes 
graphics context XSetPlaneMask: .......... XSetPlaneMask 
graphics context /logical .......scssssssesssecees XSetState 

graphics context XSetStipple: . XSetStipple 

graphics context ......... uaeabenceatecbebpavascesntvety XSetSubwindowMode 
graphics context ........ saseeedtudieaedea iinasstbivions XSetTile 

graphics context XSetTSOrigin: ........0000 XSetTSOrigin 
GraphicsiCOAtext)  rcccssuesiadseceteardvasieonacevseetes XUniqueContext 
Braphics Context fOr a QIVEMN sssssesecsseessecaee XCreateGC 
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/change clip_mask in a 
XSetRegion: set clip_mask of the 
XSetGraphicsExposures: set the 
set a nonfatal error event 

entry to the closest possible 

to the closest possible 

/colormap cell with closest 
/database RGB values and closest 
/obtain a list of hosts 

ASCII color name or translate 
read the window manager 

set a window manager 
XGetNormalHints: get the size 
XSetNormalHints: set the size 
XGetZoomHints: read the size 
XSetZoomHints: set the size 

/get events from pointer motion 
allow access from any 

list XRemoveHost: remove a 
XAddHost: add a 
XRemoveHosts: remove multiple 
XListHosts: obtain a list of 
XAddHosts: add multiple 

the name to be displayed in an 

_ to be displayed in a window’s 
XGetlIconSizes: get preferred 

in normal state (not zoomed or 
that a top-level window be 

in normal state (not zoomed or 
and retum a new colormap 
XFreePixmap: free a pixmap 

if not already loaded; get font 
/obtain the GContext (resource 
/obtain the visual 

/create a new context 

value to every pixel value in an 
memory associated with an 
rectangle from drawable into an 

a single pixel value from an 
location within the pre-existing 
set a pixel value in an 

a subimage from part of an 
XPutImage: draw an 
XDrawlImageString: draw 8-bit 
XDrawlmageString 16: draw 16-bit 
XQueryExtension: get extension 
obtain a window’s geometry 
XQueryFont: retum 

/obtain the names and 

fload a font and fill 
XGetVisualInfo: find the visual 
desired depth/ /obtain the visual 
Xmnhnitialize: 

the/ XFreeString List: free the 
and retum the number of pending 
push an event back on the 

/create an unmapped 

window and its/ XReparentWindow: 
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graphics context to a list Off .........0.0000000000 XSetClipRectangles 















graphics Context to the/ ..........0ersccrsrsseerseees XSetRegion 
graphics_exposures component in/ .......0+. XSetGraphicsExposures 
handler XSetErrorHandler: .........000esssseeeee XSetErrorHandler 
hardware color /colormap .e XOtoreColor 
hardware colors /colorcells .........ss0scsseseee XStoreColors 
hardware-supported COLOT .......0.0000eeceeeese00 XAllocColor 
hardware-supported RGB values/ .........+. XLookupColor 
having access to this display ........ssseseeee XListHosts 
hexadecimal value /values from ...........0. XParseColor 

hints property XGetWMHints: ...........0008 XGetWMHints 

hints property XSetWMHints: ..........000000 XSetWMHints 

hints property of a window in/ ...........e0000 XGetNormalHints 
hints property of a window in/ ............00008 XSetNormalHints 
hints property Of a ZOOME/ .......c.cscesecseeeee XGetZoomHints 

hints property of a ZOOME/ .........seeseeeeee0s XSetZoomHints 
Inston ysl Kecesscsestesssncscerstevestecorasensestancoeze XGetMotionEvents 
host XDisableAccessControl: .......sece00000 XDisableAccessControl 
host from the access Control ...........0ccceeesee XRemoveHost 

host to the access Control list .........c.ssseee00 XAddHost 

hosts from the access ContrOl/ ....s...sss0s00e0 XRemoveHosts 

hosts having access to this/ ........c.cccsceseesees XListHosts 

hosts to the access control list ...........0.0000¢ XAddHosts 

icon XGetIconName: get rvcccccsssccesescerere XGetIconName 

icon XSetIconName: set the name .......... XSetIconName 

ICOM SIZES aatstct abcess cetualaconssesroenestasasnsnsessteton XGetlconSizes 
iconified) /property of a window .........00. XGetNormalHints 
Iconified,, request! wicsctsscecescecesesdocsesencsseazacee XIconifyWindow 
iconified) /property of a window .........00. XSetNommalHints 

ID: (copy.a Colorinapyscsssczssstcasecssossscscssasas XCopyColormapAndFree 
DD ipetesosntosttastactes Retebdeteetsdeteomsabeteesete hseeeh antec XFreePixmap 

ID XLoadFont: load a font ........ssecsssssseees XLoadFont 

ID) associated with the/ ........cccccssesesessees XGContextFromGC 
TDifirom a) Vistralli.cssscrescccocascsscacteavessasccoates XVisualIDFrom Visual 
ID (not graphics CONtEXt) ....s..csccsessssssscecese XUniqueContext 
image XAddPixel: add a constant ........... XAddPixel 

image XDestroyImage: deallocate .......... XDestroyImage 
image /place contents Of & ........0e0ereceseseeee XGetImage 

image XGetPixel: Obtain ..........rscecscccseseee XGetPixel 

image /in drawable tO @ .....c.ccscesecscerereeeees XGetSubImage 
mage AX PiatPExelreessccesctshevamscesetsoncdeoansees XPutPixel 

image XSublmage: create .....c.scsessesseseeeee XSubImage 

image On a WiNdOW OF PIXMAP assresssereeeeee XPutimage 

image text characters XDrawImageString 
image text characters XDrawImageString 16 
AIM FOTIMATIOM Dec sasastseseresctonssesvoncsssepesseossbosctoons XQueryExtension 
information XWMGeometry: ........-.0.000000 XWMGeometry 
information about a loaded font ..........000 XQueryFont 
information about loaded fonts ..........ss000 XListFonts WithInfo 
InfOrMAatiONn SEMUCIUTE ...ccccscsccsrscsesesessscorres XLoadQueryFont 
information structures that/ ....... XGetVisualInfo 
information that matches the XMatchVisualInfo 
initialize the resource MaNaZeT .........cecereee Xmmnfnitialize 
in-memory data associated With ........ss.000 XFreeStringList 
input events /the request buffer ...........000 XPending 

input queue XPutBackEVent: .......ccecsscesee XPutBackEvent 
InputOutput Window ...ccccccssccsscrscscscessseeeee XCreateSimple Window 
insert a window between another ............. XReparentWindow 
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XDrawAre: draw an arc fitting 
determine if a point is 
XInstallColormap: 

installed /uninstall a colormap; 
/delete a colormap and 

install default if not already 

/get a list of 

memory allocated for a list of 
XIntersectRegion: compute the 
difference between the union and 
XGrabKey: grab a 

the keyboard preferences such as 
keysym,/ XLookupString: map a 
XUngrabKey: release a 

a quark list /convert a 

XmmString ToQuarkList: convert a 
XGrabKeyboard: grab the 

for the current state of the 

these/ /control the behavior of 
XAutoRepeatOff: tum off the 
XAutoRepeatOn: tum on the 
/retum the current 
XSetInputFocus: set the 
XUngrabKeyboard: release the 
/change the 

structure /destroy and free a 
XNewModifiermap: create a 
/obtain a list of the current 

click /change the 

a keysym to the appropriate 

the keysym corresponding to a 
XKeycodeToKeysym: convert a 
XRefreshKeyboardMapping: read 
retum symbols for 

/obtain the range of legal 
XSetModifierMapping: set 

off the keyboard auto-repeat 

tum on the keyboard auto-repeat 
/obtain a mapping of modifier 
convert a keycode to a 

a keysym name string to a 

/map a key event to ASCII string, 
keycode/ XLookupKeysym: get the 
XStringToKeysym: convert a 
XKeysymToString: convert a 
XRebindKeysym: rebind a 
XKeysymToKeycode: convert a 
/obtain the range of 

retum a list of database 

a resource database from command 
the XA_WM_COMMAND atom (command 
XDrawLine: draw a 
XSetDashes: set a pattem of 
XSetLineAttributes: set the 

draw multiple connected 

draw multiple disjoint 

add a host to the access control 
hosts to the access control 
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INSIde a TECtANZIE .....eccccrssssescccssececscesererere XDrawArc 

inside a region XPointInRegion: ............. XPointinRegion 
install a COLOTMAP ...esecsseereseee eatastaaeseneseretece XInstallColormap 
install default if not already ..........ccsssesees XUninstallColormap 








install the default colormap ......c.cscscsesesee XFreeColormap 
installed /uninstall a colormap; ..........02000 XUninstallColormap 
Installed COlOTMAPS .......c.cccssssecsecscesesesersees XListInstalledColormaps 


installed extensions /freE .........0ccccssseseeeeees XFreeExtensionList 


intersection of two regions 


intersection of two regions [the ..........s00 XXorRegion 
Key asacssiccccscssescasacaenssaccatsnetescsccessasssescetsbeans XGrabKey 
Key ‘CHCK( (CHANG CPsscisscretsscescsessesceatecsasesontze XChangeKeyboardControl 


eoccccccooe 


ates XUngrabKey 

ieee XmmStringToBinding Quark List 
XmmString ToQuarkList 
XGrabKeyboard 
XQueryKeymap 
XAllowEvents 

keyboard auto-repeat keys .......s.ccoseeee see NAUtORepeatOff 


key from a passive grab 
key string to a binding list and .... 
key string to a quark list........ hacrears 











keyboard auto-repeat keys XAutoRepeatOn 

keyboard focus Window ..........ccscsserssessseee XGetInputFocus 

keyboard focus Window ........0.«000 eventstorses XSetInputFocus 

keyboard from an active grab XUngrabKeyboard 
keyboard Mapping ...r.cecccscossssroses XChangeKeyboardMapping 
keyboard modifier mapping ........ XFreeModifiermap 
keyboard modifier mapping/ XNewModifiermap 
Keyboard preferences .......sscssssssseseesesees XGetKeyboardControl 
keyboard preferences such as key ........2.. XChangeKeyboardControl 
Keycode: /COnvertirscctccstecsescstensernecscoctscsanene XKeysymToKeycode 
Keycode in structure /get ......-.cccccssssssssssees XLookupKeysym 
Keycode to a KeySym .ccccccccsoocsssosseceseresees XKeycodeToKeysym 
keycode-keysym mapping from/ XRefreshKeyboardMapping 
keycodes XGetKeyboardMapping.: ......... XGetKeyboardMapping 
Keycodes for a S€TVET ..s.sscsssssssessesseessrerees XDisplayKeycodes 
keycodes to be used as modifiers/ ............ XSetModifierMapping 
keys XAutoRepeatOff: tum .......ccccssscseeee XAutoRepeatOff 

keys XAutoRepeatOn: .....ccccsoressocesssseees XAutoRepeatOn 

keys (Shift, Control, etc.) .....sccccsssssccsssssrere XGetModifierMapping 
keysym XKeycodeToKeysym: ......sssecesses XKeycodeToKeysym 
keysym XStringToKeysym: convert ....... XStringToKeysym 
keysym, and ComposeStatus ........cccsssssnee XLookupString 





keysym corresponding to a XLookupKeysym 
keysym name string to a keysym ......sss00 XStringToKeysym 
Keysym symbol to a String .....scsesssssssesseses XKeysymToString 
keysym to a string for Client ....sccssssccssscees XRebindKeysym 
keysym to the appropriate/ .....csssssssecsseees XKeysymToKeycode 
legal keycodes for @ SCLVEF ssssssscessssesssasceee XDisplayKeycodes 
levels XrmQGetSearchList: ....ccsccrsssesees XmmQGetSearchList 
line arguments /lOad ..rcccccscsecessessssecsecsecese XmmParseCommand 
line arguments) /set ....... peacdasecheucaosbaneeess .-. XSetCommand 

line between tWO POINts ...ccccccossessscesseeseens XDrawLine 

line dashes in a graphics/ ....... sossseesseensoeeees MOCLLASHES 

line drawing components in a/ ......s.ss00s000 XSetLineAttributes 
lines. XDrawLines: .......sossesseee tiebesueaekeenss XDrawLines 

lines XDrawSegMentts: .sssscssssssscecsecascessece XDrawSegments 
list XACGHOSE: ...sseccsscsosessssees avepteaseantanieeae XAddHost 

list XAddHosts: add multiple .......s.sssee0ee XAddHosts 
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with the specified string 

a host from the access control 
hosts from the access control 

to a binding list and a quark 
convert a key string to a quark 

a key string to a binding 

/search prepared 

/get the property 

polyline or curve between vertex 
polygon or curve from vertex 
XListExtensions: return a 

root XQueryTree: retum a 
XrmQGetSearchList: retum a 
this/ XListHosts: obtain a 
XListInstalledColormaps: get a 
/free memory allocated for a 

in a graphics context to a 
XTextProperty/ /obtain a 
XTextProperty/ /set the specified 
XListFonts: return a 
XGetKeyboardControl: obtain a 
requests /use access control 
structure XLoadQueryFont: 
loaded; get font ID XLoadFont: 
command line/ XrmParseCommand: 
retum information about a 

the names and information about 
load a font if not already 

get string and font metrics 

of a 16-bit character string, 

of an 8-bit character string, 

of a 16-bit character string, 

get the current pointer 

/a rectangle in drawable to a 

/set the foreground, background, 
XSetFunction: set the bitwise 
color name or/ XParseColor: 
order XLowerWindow: 
initialize the resource 

set of properties for the window 
name to a window for the window 
XGetWMHints: read the window 
XSetWMhHints: set a window 
/get data from the context 

/set a window’s standard window 
keysym, and/ XLookupString: 
XMapWindow: 

siblings XMapRaised: 
XMapSubwindows: 

change the keyboard 

get the pointer button 

set the pointer button 

/read keycode-keysym 
XGetModifierMapping: obtain a 
and free a keyboard modifier 
/create a keyboard modifier 

the next event that matches 
event that matches the specified 
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list fin-memory data associated .......ssss000 XFreeStringList 

list XRemoveHoOst: remove .ecsscccscecseseeeeree XRemoveHost 

list /remove multiple .........0.00sessseees soone MREMOVE Hosts 

list /convert a key string ....... Pentntsy sn deaaeee XmmString ToBindingQuarkList 
list XrmString ToQuark List: ........c.csseseeeee XmmStringToQuarkList 

list and a quark list /CONVETE ........0.s.ce0eee0 XmmStringToBinding QuarkList 
list for a given TESOUICE sscssssseccosseseccssesesene . XrmQGetSearchResource 

list for a WindOW ....cccce0e0e0 ase enaes teas codiaarar ie XListProperties 

list (from X10) XDraw: draw 2 ......ccccseeoee XDraw 

list (from X10) /draw a filled ........ eosesee XDrawFilled 

list of all extensions tO X/ s.v.-r.rccecccosesserere XListExtensions 

list of children, parent, and ............ ese XQuery Tree 

list of database levels ..........ssecscessesesesesere XmmQGetSearchList 

list of hosts having access tO se.s.cccecccssesvees XListHosts 

list of installed Colonmaps ......ccssssseresseseeees XListInstalledColormaps 

list of installed Extensions .......c.r.cereeeseere XFreeExtensionList 


list of rectangles /clip_mask . XSetClipRectangles 

list of strings from a specified XTextPropertyToString List 
Hist of ‘strani gS 10: Am iiccsscstssz scbssessictebstecetoaesoats XStringListToTextProperty 
list of the available font names ............... XListFonts 

list of the current keyboard/ .........cecscereevee XGetKeyboardControl 

list to allow or deny CONNECTION .........000008 XEnableAccessControl 
load a font and fill information. ...........0000 XLoadQueryFont 


load a font if not already XLoadFont 

load a resource database from .........00000 «. XrmParseCommand 
loaded font XQueryFont: ........-0ccecssessesees XQueryFont 

loaded fonts /obtain XListFonts WithInfo 
loaded; get font ID XLoadFont: ..........00+ XLoadFont 

locally XTeXxtEXtents: ......cccccsssssssesecssserees XTextExtents 











locally /string and font metrics ........s+.. X lextExtents 16 

locally /get the width in pixels ...........0000 XTextWidth 

locally /get the width in pixels ............s+00 XTextWidth16 

location XQueryPointer: ........00vrveceresverere XQueryPointer 
location within the pre-existing; .......... sevens XGEtSubImage 

logical function, and plane mask/ .......... .. XSetState 

logical operation in a graphics/ .......... sees KOCtFunction 

look up RGB values from ASCTL ......... «see XParseColor 

lower a window in the stacking ............. ... XLowerWindow 
manager Xrmlnitialize: ............00r0eccessssere Xmnlinitialize 

manager /set the MINIMUM ..........0ccsseeeees XSetStandardProperties 
manager XStoreName: assign @ .....00. sseoee MOLOTE Name 

manager hints property .......scsscvscesseeeeee soe XGetWMHints 
Manager hints Property c..c.cccrccececssseessceee + XSetWMHints 
manager (not graphics CONteXt) .......rs0«s0000 XFindContext 

MANABEL POPEMties ....sersoseresssrecsererecesoersece XSetWMProperties 
map a key event to ASCII string, .........00. XLookupString 

WADA WAN OW resessbasceaysest sctesssSoasashesbsiotsacy XMapWindow 

Map a WiNdOW ON tOP Of its ......c.ceccsserereeee XMapRaised 

map all subwindows of window .........000 XMapSubwindows 
mapping XChangeKeyboardMapping: ... XChangeKeyboardMapping 
mapping XGetPointerMapping: ..........+0 XGetPointerMapping 
mapping XSetPointerMapping: ...........000 XSetPointerMapping 
mapping from server into XILib .......sscsssee0 XRefreshKeyboardMapping 
mapping of modifier keys (Shift,/ ............ XGetModifierMapping 
Mapping structure /destrOy. ........-.0cceresseeee XFreeModifiermap 
MAPPING StFUCLUTE ....secvcceessoees aeegitseseeeenatoh XNewModifiermap 
mask XMaskEvent: remove ....ceccccesvessees XMaskEvent 

mask and window /remove the next ........ XWindowEvent 
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the next event that matches 
both passed window and passed 
XSetPlaneMask: set the plane 
Aogical function, and plane 
Anformation structures that 
XPeeklfEvent: get an event 
XIfEvent: wait for event 

/the next event in queue that 
remove the next event that 
/remove the next event that 

/the visual information that 
/remove the next event that 
passed/ /remove the next event 
check the event queue for a 
/return the next event in queue 
function XFree: free specified 
XFreeFontPath: free the 
XFreeFontNames: free the 
XFreeFontInfo: free the 
XFreeExtensionList: free 
XDestroyAssocTable: free the 
XDestroyImage: deallocate 
XCreateImage: allocate 
Xpemnalloc: allocate 

database/ XrmMergeDatabases: 
x /obtain error 

the server for string and font 
get string and font 

{the server for string and font 
string,/ /get string and font 
XSetStandardProperties: set the 
XSetArcMode: set the arc 

/set the subwindow 

/change the close down 

etc.) /obtain a mapping of 
/destroy and free a keyboard 
/cyeate a keyboard 

/set keycodes to be used as 

/get events from pointer 
XMoveWindow: 

point on the/ XWarpPointer: 
XDrawArcs: draw 

XFillArcs: fill 

XDrawLines: draw 
XDrawSegments: draw 
control/ XRemoveHosts: remove 
control list XAddHosts: add 
XDrawPoints: draw 

/draw the outlines of 
XFillRectangles: fill 

a read-only colorcell from color 
RGB values from color 

a read/write colorcell by color 
/get a resource value using 

/get a resource from 

database using a quark resource 
with separate resource 

atom XGetAtomName: get a string 
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mask; don’t wait /TEMOVE ....ccccscsscsscssesesee XCheckMaskEvent 
mask; don’t wait /event matching ........... XCheck WindowEvent 
mask in a graphics CONtEXt ........0000ecsceeveeee XSetPlaneMask 

mask in a graphics CONTEXE .......0-cceseereee XSetState 

match the specified template ..........s:cssseeee XGetVisualInfo 
matched by predicate procedure/ .........00+ XPeeklifEvent 
matched in predicate procedure .........c0000 XIfEvent 

matches event type; don’t Walt ........0-e000 XCheckTypedEvent 
matches mask XMaskEvent: ........scccseeee XMaskEvent 

matches mask; don’t Wait ...cccccceoee XCheckMaskEvent 
matches the desired depth and/ . XMatchVisualInfo 
matches the specified mask and/ ...........0+ XWindowEvent 
matching both passed window and .......... XCheck WindowEvent 
matching event XCheckIfEvent: ............. XCheckIfEvent 
matching type and WINdOW ..rcecccccorseccerere XCheckTypedWindowEvent 





memory allocated by an Xlib 


memory allocated by XGetFontPath ........ XFreeFontPath 
memory allocated by XListFonts. .......... XFreeFontNames 
memory allocated by/ .........scccssecssocscssseeee XFreeFontInfo 


memory allocated for a list of/ XFreeExtensionList 
memory allocated for an/ ..........s0cscseeeseesees XDestroyAssocTable 



















memory associated with:an image ........... XDestroyImage 
memory for an XImage structure .........000 XCreateImage 

memory never to be freed ..........0scececsessees Xpermalloc 

merge the contents Of ONE .........0.0cceseeseee0 XmmMergeDatabases 
messages from the error database ........... XGetErrorDatabaseText 
MINELTL CS QUETY meversetecctertetereoreovanticasavcteeeetere XQueryTextExtents 
metrics locally XTextExtents: ..........s00000 XTextExtents 

metrics of a 16-bit character ........0secseeee0 XQueryTextExtents 16 
metrics of a 16-bit character .......... XTextExtents 16 
minimum set of properties for/ XSetStandardProperties 
mode in a graphics COnteXt ........00. XSetArcMode 

mode in a graphics context ..... XSetSubwindowMode 
MOE Of a CLIENE .....crccscereseessseeeees XSetCloseDownMode 
modifier keys (Shift, Control, ............ccs000e XGetModifierMapping 
MOdifier MAPPING StTUCtUTE ........ccccccecereees XFreeModifiermap 
modifier mapping structure ........... XNewModifiermap 
modifiers (Shift, Control, etc.) ...... XSetModifierMapping 
motion history buffer ..........-00sssse0 XGetMotionEvents 
MOVE & WINGOW .esccsorsssrsesscscsscvceserecersecosoree XMoveWindow 

move the pointer to another ...........csseseeseee XWarpPointer 

Multiple arcs ..........ccevers acecenetetteatenctaretteetgs XDrawArcs 

Multiple ALCS «...ccccoseceees aetenevererotiasstereneets XFillArcs 

multiple connected lines. .... ... XDrawLines 

multiple disjoint lines .......... ... XDrawSegments 
multiple hosts from the access ...... .. XRemoveHosts 
multiple hosts to the ACCESS ...v.sevccerereeeeee XAddHosts 

MUltiple POINES. .....c.csrersccccrcsesererscecessasrseces XDrawPoints 

multiple rectangles ..........000e0 .«. XDrawRectangles 
multiple rectangular areas XFillRectangles 

name XAllocNamedColor: allocate ........ XAllocNamedColor 
name /closest hardware-supported .......... XLookupColor 

name /set RGB values Of .....c.sssscsssessssereees XStoreNamedColor 
name and Class aS QUATKS .....cssscsssesssessesees XmnQGetResource 
Name and Class AS SLTINBS «.....sccssecescesveeseeee XmmGetResource 
name and string Value [10 a ..ccscececocesecneese XmmQPutStringResource 
name and value /specification ........000e00 XrmPutStringResource 
name for a property BiVEN its ......csscceresseees XGetAtomName 
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/ap RGB values from ASCII color 
an atom for a given property 
/convert a keysym 

manager XStoreName: assign a 
window’s/ XSetIconName: set the 
XGetIconName: get the 
XDisplayName: report the display 
XFetchName: get a window’s 

a list of the available font 
XListFonts WithInfo: obtain the 
Xpermalloc: allocate memory 
XCreateAssocTable: create a 
/copy a colormap and retum a 
XUniqueContext: create a 
XCreateRegion: create a 
XInsertModifiermapEntry: add a 
screen with/ XCreateGC: create a 
XrmUniqueQuark: allocate a 

type and window /returm the 
XCheckTypedEvent: retum the 
XCheck WindowEvent: remove the 
XNextEvent: get the 
XMaskEvent: remove the 
XCheckMaskEvent: remove the 

’ XWindowEvent: remove the 
XSetErrorHandler: set a 

/allocate read/write 

/allocate read/write 

the server XNoOp: send a 

/hints property of a window in 
/hints property of a window in 

a colomnap; install default if 
XLoadFont: load a font if 

data from the context manager 

{to a window and context type 
/create a new context ID 

/of a window in normal state 

/of a window in normal state 
queue XEventsQueued: check the 
/request buffer and return the 
current state of/ XQueryKeymap: 
code XGetErrorText: 

access to this/ XListHosts: 
XTextPropertyToString List: 
keyboard/ XGetKeyboardControl: 
keys/ XGetModifierMapping: 

an image XGetPixel: 

information XWMGeometry: 
from Xlib’s GC/ XGetGCValues: 
table XLookUpAssoc: 

error/ XGetErrorDatabaseText: 
of colorcells XQueryColors: 
property/ XGetWindowProperty: 
cursor, tile,/ XQueryBestSize: 
window XGetWindowAttributes: 
drawable XGetGeometry: 

fill tile shape XQueryBestTile: 
supple/ XQueryBestStipple: 


Permuted Index 





name or translate hexadecimal/ .........ss00++ XParseColor 
name string XIntermAtom: retum ............ XIntemAtom 
NAME StTINg tO a KEYSYM ovesssccvsscrseereeeecsees XStringToKeysym 
name to a window for the window .......s:+ XStoreName 
name to be displayed in a .......csecssscseseseeees XSetIconName 
name to be displayed in an iCOM .....scssessee XGetlconName 
name (when Connection tO a/ .........0.00000000 XDisplayName 
name (XA_WM_NAME property) .......... XFetchName 
names XListFonts: return ......0ececssecsseseone XListFonts 

names and information about/ ... XListFonts WithInfo 
Never to be freed .....cscscscsseseseeoees Xpenmalloc 





Pa TT) XCreateAssocTable 
XCopyColormapAndFree 
XUniqueContext 


new association table (X10) 
new colormap ID 
new context ID (not graphics/ ... 




















new empty region XCreateRegion 

new entry to an XModifierKeymap/ ........ XInsertModifiermapEntry 
new graphics context for a ZiVEN ........0000 XCreateGC 

TLE Wi GUAT ratoatas can ssencdertnocenorsonerssouszonecasyebeene XmmUniqueQuark 

next event in queue matching XCheckTypedWindowEvent 
next event in queue that matches/ ............ XCheckTypedEvent 
next event matching both passed/ ............ XCheck WindowEvent 
next event of any type or window .......... XNextEvent 

next event that matches mask ............s000008 XMaskEvent 

next event that matches mask;/ .......scccssee XCheckMaskEvent 
next event that matches the/ XWindowEvent 
nonfatal error event handler XSetErrorHandler 
(nonshareable) color planes XAllocColorPlanes 
(nonshared) COlorcells ..........cscecocceeseseseoess XAllocColorCells 
NoOp to exercise connection With .......... XNoOp 

normal state (not ZOOMEM OF/ ......s0ececeeeeeres XGetNomnalHints 
normal state (not ZOOME OF/ .........cesececere XSetNormalHints 

not already installed /uninstall ..............0+ XUninstallColormap 
not already loaded; get font ID ...........00000 XLoadFont 

(not graphics context) /get «ee XFindContext 

(not graphics CONtEXt) .........00000 XSaveContext 

(not graphics CONtEXt) .......-.c000000 XUniqueContext 

(not zoomed or iconified) .......... XGetNormalHints 

(not zoomed or iconified) ........+. XSetNormalHints 
number of events in the EVENL .........csssce0e XEventsQueued 
number of pending input events ...........0008 XPending 

obtain a bit vector for the ......serecssscecsssscees XQueryKeymap 

obtain a description Of C7TOF ......csesessesseens XGetErrorText 

obtain a list of hosts having .........s-.cccscecseee XListHosts 

obtain a list of strings from a/ ....s.0.se00e0ece0 XTextProperty ToString List 
obtain a list of the CUTTENL .......s.csssssessesseess XGetKeyboardControl 
obtain a mapping of modifier ....... «ee XGetModifierMapping 
obtain a single pixel value from soe KGEtPixel 

obtain a Window’s ZEOMELTY .....cescecssseeees XWMGeometry 

obtain components of a given GC ........000 XGetGCValues 

obtain data from an association ........s.sseee XLookUpAssoc 

obtain error messages from the .... XGetErrorDatabaseText 
obtain RGB values for an array «.....0..s0000 XQueryColors 

Obtain the atom type and ........cccsosssceesessee XGetWindowProperty 
obtain the "best" supported .......... XQueryBestSize 


obtain the current attributes of XGetWindowAttributes 
obtain the current geometry of XGetGeometry 

obtain the fastest supported ..........secsseeeses XQueryBestTile 

obtain the fastest supported ...........0000esee0 XQueryBestStipple 





WZ 


ID) associated/ XGContextFromGC: 
about/ XListFontsWithInfo: 
keycodes for/ XDisplayKeycodes: 
for a specified/ XQueryColor: 
formats for/ XListPixmapFormats: 
Visual XVisualIDFrom Visual: 
that matches/ XMatchVisualInfo: 
structure/ XGetRGBColormaps: 
tum the screen saver on or 

keys XAutoRepeatOff: tum 

two regions have the same size, 
XOffsetRegion: change 

an 8-bit text string, foreground 

/set the bitwise logical 
XGetDefault: extract an 

child to the top of the stacking 

' to the bottom of the stacking 
size, border width, or stacking 


lower a window in the stacking, 


to the top of the stacking 
/circulate the stacking 

/change the stacking 
XSetClipOrigin: set the clip 

/set the tile/stipple 
XDrawRectangle: draw an 
XDrawRectangles: draw the 
XGetSelectionOwner: retum the 
XSetSelectionOwner: set the 
get the current screen saver 

grab /change the 
XSetScreenSaver: set the 
between another window and its 
retum a list of children, 

create a subimage from 
matching both passed window and 
{the next event matching both 
release a button from a 
XUngrabKey: release a key from a 
get the current font search 

set the font search 

graphics/ XSetDashes: set a 
buffer and returm the number of 
repaint/ /change a window border 
window /set the background 
XGetPixel: obtain a single 
context /set the background 
context /set the foreground 

/add a constant value to every 
XPutPixel: set a 

a drawable with depth, applying 
XTextWidth16: get the width in 
XTextWidth: get the width in 
XCreatePixmap: create a 

draw an image on a window or 
server /obtain the supported 
XFreePixmap: free a 
XSetClipMask: set clip_mask 
data. /create a 
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obtain the GContext (TESOUTCE ..esescscscseseee XGContextFromGC 








obtain the names and information .......... ». XListFonts WithInfo 
obtain the range of legal .........000000000ce08 .. XDisplayKeycodes 
obtain the RGB values and flags .........s0. XQueryColor 

obtain the supported pixMap ........cececsceeeee XListPixmapFormats 
obtain the visual ID from a XVisualIDFrom Visual 
obtain the visual information .........0.0000000 XMatchVisualInfo 
obtain the XStandardColormap . XGetRGBColormaps 
off XForceScreenSaver: «0.000000 : XForceScreenSaver 
off the keyboard auto-repeat ......c.cccssecsseee XAutoRepeatOff 
offset, and shape /determine if ............000. . XEqualRegion 

Offset Of a TE GION <triscenesesecsenterovcetenpesssuatscss XOffsetRegion 

only XDrawString: draw .cvs.v00e Rtenscoseeesied XDrawString 





operation in a graphics context 
option value from the resource/ .... 


















order /circulate the bottom ......s.00000 ssseevee X CirculateSubwindowsDown 
order /circulate the top Child ............0000s0e XCirculateSubwindowsUp 
order /the window position, XConfigureWindow 
Order XLOwerWindow: .vcvccccccsoscsescsssereeee XLowerWindow 

Order /raise a WINdOW .ecoreeveseeee ieeansesbeneeees XRaiseWindow 

order of children up Or dOWM ........s.s00000e008 XCirculateSubwindows 
order of siblings .......0000005 Rezecshccesscaseavszacsseed XRestack Windows 

Origin in a graphics CONtEXE ..cccccccsrossesereee XSetClipOrigin 

origin in a graphics context XSetTSOrigin 

Outline of a rectangle ........csscsscsesereeserecseee XDrawRectangle 

outlines of multiple rectangles ..........s00000 XDrawRectangles 

Owner Of a SELECLION .sererscrossseesosvesssveerseceees XGetSelectionOwner 
Owner Of a SELECTION ..sercsroressecessorseseseresccese XSetSelectionOwner 
parameters XGetScreenSaver;: .........cec00000 XGetScreenSaver 
parameters of an active POinter .......0e000e0 XChangeActivePointerGrab 
parameters of the screen SAVEF ......ccesee0e XSetScreenSaver 

Parent /insert a WINdOW esccsorrsrvsseeeroesssees XReparentWindow 
parent, and root XQueryTTee: .......cccece0e00 XQuery Tree 

part of an image XSublImage: ........... sscoee NOUDIMAage 

passed mask; don’t wait /event ...........000 XCheck WindowEvent 
passed window and passed mask;/ ........00. XCheckWindowEvent 
passive grab XUngrabButton: ...........ssse0« XUngrabButton 

passive grab ......00 eecuatbatercrsvacccsnasscceen soos MUngrabKey 

path XGetFontPath: ........0cvecsessrosssssceseee XGetFontPath 

path XSetFontPath: .........0000 acest ataeceoetae ... XSetFontPath 

pattern of line dashes in & ....cccssscsssrcesssoeees XSetDashes 

pending input events /request ........c00e00e00 XPending 

pixel value attribute and ......csossscesssessees +» XSetWindowBorder 
pixel value attribute Of a .....cccsssssssessees .. XSetWindowBackground 
pixel value from an image .....0s00v00ev0000 XGEtPixel 

pixel value in a graphics .......00000000000se000 ROCLBACkground 

pixel value in a graphics ........00cscessersseseeee XSetForeground 

Pixel value in an IMAZeE ......srvscervessseeeeeseeee RADIPIxel 

Pixel value in an IMage w.rcccccecorsscscssssceesees XPutPixel 

pixel values /of a drawable into ..........000 XCopyPlane 

pixels of a 16-bit character/ «000s XTextWidth16 

pixels of an 8-bit character .........cssssosees XTextWidth 

PIXIVIAP) ecvecvaccssacosstesalstsctasacscdevicents ssessesseeers MCTEAtEPIXMAp 

pixmap XPutlmage: ........sscsrvees ssvseesteosens MPULLMAZe 

pixmap formats for @ ZiVEN .....sssecccssserseee XListPixmapFormats 
PIXMAP ID ......recoresesseoseceserseeseeneessosevavsseeeeee MPTECPIXMAP 

pixmap in a graphics CONteRt ssssssveseeseseee KOCLCLipMask 

pixmap with depth from bitmap ...........000 XCreatePixmapFromBitmapData 
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from drawable into/ XGetImage: 
XSetPlaneMask: set the 

Aogical function, and 
XCopyPlane: copy a single 
read/write (nonshareable) color 
free colormap cells or 
XDrawPoint: draw a 
XPointInRegion: determine if a 
/move the pointer to another 
XGrabPointer: grab the 
XGrabButton: grab a 
XGetPointerMapping: get the 
XSetPointerMapping: set the 

{the behavior of keyboard and 
XUngrabPointer: release the 

the parameters of an active 
XQueryPointer: get the current 
/get events from 

/change the 

/get the current 

screen XWarpPointer: move the 
draw a line between two 
XDrawPoints: draw multiple 
generate a region from 
XFillPolygon: fill a 

list) XDrawFilled: draw a filled 
list (from X10) XDraw: draw a 
XDrawText: draw 8-bit 
XDrawText16: draw 16-bit 
window/ XParseGeometry: generate 
/change the size and 

stacking/ /change the window 
/colormap entry to the closest 
/colorcells to the closest 

wait for event matched in 

/get an event matched by 

to a location within the 

/change the pointer 

a list of the current keyboard 

get the current pointer 

/change the keyboard 
XGetlIconSizes: get 
XmmQGetSearchResource: search 
for event matched in predicate 
/an event matched by predicate 
for all events and errors to be 
display /disconnect a client 
XOpenDisplay: connect a client 
read one of a window’s text 

set one of a window’s text 
window’s standard window manager 
/rotate properties in the 

manager /set the minimum set of 
XRotate WindowProperties: rotate 
XDeleteProperty: delete a window 
get a window’s name (XA_WM_NAME 
associated with the specified 

get the standard colormap 
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place contents of a rectangle ...........00000000 XGetImage 

plane mask in a graphics CONtEXt ......0.0000 XSetPlaneMask 
plane mask in a graphics CONtEXt .......00000 XSetState 

plane of a drawable into a/ .......000sescerseeee XCopyPlane 
planes s/allOCateiisciccsessstesscctccsassctachossivossieer XAllocColorPlanes 















planes XFreeColors: ...... XFreeColors 

POINE .....00000 ecacatucheanasavssctees eatacvestiesasscsvesvisead XDrawPoint 

POINt is inside a TEGION ......ec.cesrserereeeesvees ... XPointInRegion 
point on the screen ....... susuenaaressowsagiseateiees® XWarpPointer 
POUALE Mc cecccctncncesecsovocscepsorosctesccsbestohevoubstesaras XGrabPointer 
POINLEF DULLON Fee ese sscessnesepeavsesvedencosoncntunven XGrabButton 

POinter button MAPPING .........c.rescssesesssereee XGetPointerMapping 
POinter button MappiING ...........0sesseessserereees XSetPointerMapping 
pointer events when these/ ............0esseees XAllowEvents 
Pointer from an active Zrab ...sccccoscsessessseee XUngrabPointer 
Pointer grab /change .se.cscccssssssscsssscesessecees XChangeActivePointerGrab 
POINter LOCATION ......crsereseeeereesees XQueryPointer 
pointer motion history buffer XGetMotionEvents 
POinter preferences... XChangePointerControl 
POINTer Preferences tersictsiecedcbascsebeseseccoeonstese XGetPointerControl 
pointer to another point on the ..........0.0000« XWarpPointer 
points XDrawLine: . ater accpare tea ieitcan cvcteerertae XDrawLine 

SOMES decvscsrcstacovevenectuokssteavvassueteetevegs cecteseceete XDrawPoints 

Points XPolyZonREBion: .....scscssscsscscereress XPolygonRegion 
POLY OM iecssconcecesctecuvectscsvsscaeensuanes XFillPolygon 
polygon or curve from vertex XDrawFilled 
polyline or curve between Vertex .........000 XDraw 

polytext strings XDrawText 





polytext strings XDrawText16 





position and size from standard XParseGeometry 
POSItION Of & WINdOW ..ssccccssscecscsssssesecesscers XMoveResize Window 
position, size, border width, OF ..........00s000 XConfigureWindow 
possible hardware COIOT ....sssssessssessessseseees XStoreColor 













possible hardware colors ......000» Paseo XStoreColors 

predicate procedure XIfEvent: ...........0000 XIfEvent 

predicate procedure Without) .........s0sse0 XPeeklfEvent 

pre-existing image /in drawable ............0 XGetSubImage 

PFCLELEN CES Hers orossurseecesvavectbvvesssevevezoncdacdasoves XChangePointerControl 
preferences /obtain ..........000008 fostyacidanowentee XGetKeyboardControl 
preferences XGetPointerControl: ..........+. XGetPointerControl 
preferences such as key Click ......cssssssessee XChangeKeyboardControl 
preferred 1COn SIZES ® asc sccsclevctcecebsdecsnssteucnene XGetlconSizes 

prepared list for a given/ ........ssesssesssssessees XrmmQGetSearchResource 
procedure XIfEvent: Wait .....cccssscssssssceseees XIfEvent 

procedure without removing it/ ..........0000 XPeekIfEvent 

processed by the server /Wait .....ccssssssssoses XSyne 

program from an X server and .......scsssvees XCloseDisplay 

PTOZTAM tO aN X SETVET eescscosssovcesssceceseseeces XOpenDisplay 

properties XGetTextProperty: ...........000000 XGetTextProperty 
properties XSetTextProperty: ......ccsscsse XSetTextProperty 
PTOPErtics /Set a c.rccccssccoressosesecssseresserecesseees XSetWMProperties 
PTOPETLIES ATTAY ....rscseveecsveereeee XRotateWindowProperties 
Properties for the WINdOW .....sscessssesesssseeee XSetStandardProperties 
properties in the prorerties/ XRotateWindowProperties 
PPEOPCLEY serocasvres tase setteaceutceeobeactsceeesesaibentines XDeleteProperty 
property) XFetchName: ....... XFetchName 

Property /StrUCtUTE .......0.00008 paqutatabscch ence XGetRGBColormaps 
property XGetStandardColormap.: .......... XGetStandardColormap 
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read the window manager hints 

read a window’s XA_WM_ICON_NAME 
read a window’s XA_WM_NAME 

a window’s XA_WM_NORMAL_HINTS 
read a window’s XA_WM_SIZE_HINTS 
the value of the XA_WM_ICON_SIZE 
change the standard colormap 

set a window’s WM_CLIENT_MACHINE 
a window’s WM_COLORMAP_WINDOWS 
set a window manager hints 

set a window’s XA_WM_ICON_NAME 
set a window’s XA_WM_NAME 

a window’s XA_WM_NORMAL_HINTS 
set a window’s WM_PROTOCOLS 

set a window’s WM_SIZE_HINTS 
XChangeProperty: change a 

/set the XA_WM_TRANSIENT_FOR 
/obtain the atom type and 

/get a string name fora 
XGetFontProperty: get a font 
XListProperties: get the 

/return an atom for a given 

/get the XA_WM_CLASS 

/get the XA_WM_TRANSIENT_FOR 
/set the XA_WM_CLASS 

state (not/ /get the size hints 

state (not/ /set the size hints 

/read the size hints 

/set the size hints 

XGetSizeHints: read any 

/set the value of any 

queue XPutBackEvent: 

convert a string to a 

XmmUniqueQuark: allocate a new 

string to a binding list and a 

/convert a key string to a 

value /to a database using a 
XrmQuarkToString: convert a 

value using name and class as 

into a database using 

font metrics XQueryTextExtents: 

font/ XQueryTextExtents 16: 

number of events in the event 

without removing it from the 

without removing it from the 

push an event back on the input 
XCheckIfEvent: check the event 

/returm the next event in 

don’t/ /retum the next event in 

the request buffer (display all 

stacking order XRaise Window: 
XDisplayKeycodes: obtain the 
XReadBitmapFile: 

property XGetWMIconName: 

property XGetWMName: 
XGetWMNomnalHints: 

property XGetWMSizeHints: 
XA_SIZE_HINTS XGetSizeHints: 
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property XGetWMHints: ...........sccsrscecesere XGetWMHints 


property XGetWMIconName: ......seseeveee XGetWMIconName 
property XGetWMName: .......csessseeeeee XGetWMName 
property /read .......... eatesibesabscesbaccseecstivincees XGetWMNomnalHints 
property XGetWMSizeHints: ........0.0000000 XGetWMSizeHints 


property XSetIconSizes: set ......csccsecssrerees XSetIconSizes 


property XSetStandardColormap: ........... XSetStandardColormap 
property XSetWMClientMachine: .......... XSetWMClientMachine 





PTOpErty /SEt .....ccccecessseee sabttn Sitbandbaessteneneees XSetWMColormapWindows 
property XSetWMHints: .........0sccsservssseeses XSetWMHints 

property XSetWMIconName: .........0.se000 XSetWMIconName 
property. XSetWMName: ........ecssssessseevee XSetWMName 

property XSetWMNormalHints: set ........ XSetWMNomnalHints 
property XSetWMProtocols: ......ccssssees XSetWMProtocols 

property XSetWMSizeHints: .........0ecseeees XSetWMSizeHints 

property associated With af .....ccecsessssssseeee XChangeProperty 





property for a window XSetTransientForHint 
property format for a WINdOW ...-v.0000000000 XGetWindowProperty 
PTOPErty ZIVEN Its ALOM wrssecsocccsssseseesesencees XGetAtomName 






property given its atom XGetFontProperty 


property list for a window ........ XListProperties 
PToperty NAME SITING ...edscrecveeees XIntemAtom 
property of a window ........00 XGetClassHint 
Property of a WiNdOW .........000000 XGetTransientForHint 
Property Of a WINdOW nesssecocecscscsscessorcersseres XSetClassHint 
property of a window in normal ........000000 XGetNormalHints 
property of a window in nommal ...........00 XSetNomnalHints 


XGetZoomHints 
XSetZoomHints 


property of a zoomed window 
property of a zoomed window 





property of type XA_SIZE_HINTS......... XGetSizeHints 

property of type XA_SIZE_HINTS ......... XSetSizeHints 

push an event back on the input .......ss0000 XPutBackEvent 

quark XrmStringToQuark: ......c.cscscssesssoee XmmString ToQuark 
GUaTK aecectevatensercissonsteisstccsccccnsetosecsacsscessoperes XmmUniqueQuark 

quark list /convert a Key «......cssssrsssssssoesees XmmString ToBindingQuarkList 
quark List ........cececeseees pehvacrapniteostedesssdetaxeroee XmmStringToQuark List 
quark resource name and String .........000e XmmQPutStringResource 
QULATK Ola SELIM Gi, csnoeocttotecstanccsvecsheorasseasoutes XrmQuarkToString 
Quarks /get a TESOUTCE ..rsecscssscssrsscsoeesseesees XmmQGetResource 
quarks /a resource specification .........0000 XmmQPutResource 
query the server for string and ...........s0000 XQueryTextExtents 
query the server for string and .........0sss00 XQueryTextExtents 16 
queue XEventsQueued: check the ........... XEventsQueued 

queue XPeekEvent: get an event ..........006 XPeekEvent 

queue /by predicate procedure ...........s.c006 XPeeklfEvent 

queue XPutBackEvent: .........cssssssssssssessese XPutBackEvent 

queue for a matching CVENL ......ccsccsseseseee XChecklfEvent 

queue matching type and window ........... XCheckTypedWindowEvent 
queue that matches event type; «s.r XCheckTypedEvent 
queued requests) XFlush: flush ........s00000 XFlush 

raise a Window to the top Of the ........006. XRaise Window 

range of legal keycodes for a/ ....ssosssecoee XDisplayKeycodes 

read a bitmap from disk .......c0vcsecessersseenees XReadBitmapFile 

read a window’s XA_WM_ICON_NAME XGetWMIconName 
read a window’s XA_WM_NAME. ......... XGetWMName 

Tad a Wind OW?S/iicvcssscavissceactvesattenedstoineestes XGetWMNomnalHints 
read a window’s XA_WM_SIZE_HINTS XGetWMSizeHints 
read any property Of type ...c.ccccssssssessessseeee XGetSizeHints 
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server/ XRefreshKeyboardMapping: 
properties XGetTextProperty: 

a zoomed window XGetZoomHints: 
property XGetWMHints: 
XAlocNamedColor: allocate a 
closest/ XAllocColor: allocate a 
name /set RGB values of a 

/set or change the RGB values of 
/or change the RGB values of a 
XAllocColorPlanes: allocate 
XAllocColorCells: allocate 

client XRebindKeysym: 

that a top-level window be 

draw an arc fitting inside a 

draw an outline of a 

XClipBox: generate the smallest 
XGetlimage: place contents of a 
location/ XGetSubImage: copy a 
XRectInRegion: determine if a 
XUnionRectWithRegion: add a 
draw the outlines of multiple 

a graphics context to a list of 
XFillRectangle: fill a 

XClearArea: clear a 
XFillRectangles: fill multiple 
region XShrinkRegion: 

smallest rectangle enclosing a 
create anew empty 

storage associated with a 

change offset of a 

determine if a point is inside a 

if a rectangle resides in a 

context to the specified 

reduce or expand the size of a 

add a rectangle to a 
XSubtractRegion: subtract one 
XPolygonRegion: generate a 
XEmptyRegion: determine if a 
compute the intersection of two 
compute the union of two 

union and intersection of two 
XEqualRegion: determine if two 
grab XUngrabButton: 
XFreeCursor: 

grab XUngrabKey: 

active grab XUngrabKeyboard: 
active grab XUngrabPointer: 
XUngrabServer: 

/destroy a client or its 

control list XRemoveHost: 
client’s/ XChangeSaveSet: add or 
client’s/ XRemoveFromSaveSet: 
access control/ XRemoveHosts: 
both passed/ XCheck WindowEvent: 
matches mask XMaskEvent: 
matches mask;/ XCheckMaskEvent: 
matches the/ XWindowEvent: 
XPeekEvent: get an event without 
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read keycode-keysym mapping from ...... XRefreshKeyboardMapping 
read one Of a WiNdOW’S tEXt ..s.ccscsreeceeesees XGetTextProperty 

read the size hints property Of ..........sss0e0 XGetZoomHints 

read the window manager hints. ........2.s00« XGetWMHints 


read-only colorcell from color/ +o. XAllocNamedColor 
read-only colormap cell with .. XAllocColor 
read/write colorcell by color....... ... XStoreNamedColor 
read/write colorcells to the/ .........sececeeessees XStoreColors 


read/write colormap entry to the/ ........s0e0 XStoreColor 








read/write (nonshareable) color/ ..- XAllocColorPlanes 
read/write (nonshared)/ .........0.e000000 .«. XAllocColorCells 

rebind a keysym to a string for ....... ... XRebindKeysym 
reconfigured /TEquest ........sseserssvscssseseerees XReconfigureWM Window 


rectangle XDrawATIc: ..s.sscecsssesscsssessseseseoee XDrawArc 





rectangle XDrawRectangle: ....... ... XDrawRectangle 
rectangle enclosing a TEZION .......0.ceceeeseee XClipBox 
rectangle from drawable into an/ ...........+ XGetImage 
rectangle in drawable to a .......c.cssscseesevees XGetSublImage 


rectangle resides in a region XRectInRegion 
rectangle to a region XUnionRectWithRegion 
rectangles XDrawRectangles: ........ssscsse0 XDrawRectangles 
rectangles /change clip_mask in .........0000 XSetClipRectangles 
TECtan SUlAL ATCA scsccrsscavecescsecrasencssveensocuczases XFillRectangle 
rectangular area in a window . XClearArea 














TECLANBUILAL ATEAS «...sscsvssevesseevsessscsonvevereresee XFillRectangles 
reduce or expand the size Of a .......c.s00e000 XShrinkRegion 
region XClipBox: generate the .......0.00000 XChpBox 
region XCreateREgion: ..........cccssscssssevees XCreateRegion 
TE ZION /deallocate ..ccccccccccccorssseescrsessceses XDestroyRegion 
region XOffsetRegion: ..........cccscrscsscscssoese XOffsetRegion 
region XPointInRegion: ..............ccccecssseees XPointinRegion 
region XRectInRegion: determine .......... XRectInRegion 
region /of the graphics XSetRegion 
region XShrinkREZion: .........00ccvevcsessecosee XShrinkRegion 


region XUnionRectWithRegion: .........000 XUnionRectWithRegion 





TEgZiON from ANOthE .......ccrcscssssscsccescerererere XSubtractRegion 
TEZION fFOM POINLS .......cccccorseseseccsserssererseers XPolygonRegion 
FE SILOM IS CMAPLY > cessscacsvovesseutesnceseasstecsvenesensts XEmptyRegion 
regions XIntersectREgion: ...........cscecsseee XIntersectRegion 
regions XUnionRegion: ......... «e XUnionRegion 
regions /difference between the .... ... XXorRegion 
regions have the same SiZe,/ ..........sececssees XEqualRegion 
release a button from a PassiVe ........s00000 XUngrabButton 
TELS ASE' A) CUTSOT cesssesesscecsnesesseastertvcessvatowecses XFreeCursor 
release a key from a passive XUngrabKey 






release the keyboard from an ... XUngrabKeyboard 


release the pointer from an ......... .. & UngrabPointer 
release the server from grab ... XUngrabServer 
TEMAINING TESOUTCES serscccscsceceserecesesesceceseces XKiliClient 

remove a host from the access ......csses00 XRemoveHost 

remove a subWindow from the ......0..000000 XChangeSaveSet 
TeMOvVe a WiINdOW from the .........cccecveeseeees XRemoveFromSaveSet 


remove multiple hosts from the XRemoveHosts 





remove the next event matching XCheck WindowEvent 
remove the next event that ..........c0cccssssseee XMaskEvent 

remove the next event that .........cccccseserssees XCheckMaskEvent 
remove the next event that ...........ccscessecees XWindowEvent 
TEMOVINE it from the QUEUE .........cccscecerere XPeekEvent 
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/oy predicate procedure without 
border pixel value attribute and 
window border tile attribute and 
connection to a/ XDisplayName: 
number of/ XPending: flush the 
events and/ XSync: flush the 
queued/ XFlush: flush the 

be iconified XIconifyWindow: 
be/ XReconfigureWM Window: 
be withdrawn XWithdrawWindow: 
list to allow or deny connection 
buffer (display all queued 
XResetScreenSaver: 

/determine if a rectangle 

search prepared list for a given 
extract an option value from the 
XrmmDestroyDatabase: destroy a 
a resource specification to a 


a resource specification into a_ 


line/ XrmParseCommand: load a 
XrmPutFileDatabase: store a 
strings XrmGetResource: get a 
the/ /obtain the GContext 
XmmMnitialize: initialize the 

ho a database using a quark 
/specification with separate 
XrmQPutResource: store a 
XrmPutResource: store a 
XmmQPutStringResource: add a 
XrmPutLineResource: add a 
XrmPutStringResource: add a 
class as/ XrmQGetResource: get a 
a client or its remaining 

and pointer events when these 
XrmGetFileDatabase: 

to X supported/ XListExtensions: 
parent, and root XQueryTree: 
XmmQGetSearchList: 

font names XListFonts: 

/copy a colormap and 

property name/ XIntemAtom: 
XFetchBuffer: 

XFetchBytes: 

loaded font XQueryFont: 
XGetKeyboardMapping: 

focus window XGetInputFocus: 
XCheckTypedWindowEvent: 
that matches/ XCheckTypedEvent: 
/flush the request buffer and 
XGetSelectionOwner: 
XLookupColor: get database 
XQueryColor: obtain the 
colorcells XQueryColors: obtain 
or/ XParseColor: look up 

/and closest hardware-supported 
colorcell/ XStoreNamedColor: set 
XStoreColor: set or change the 
XStoreColors: set or change the 
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removing it from the QUEUE ......00ec00000 sesvee MPeekIfEvent 































repaint the border /a WindOW ..esccorsessseseees XSetWindowBorder 
repaint the border /change @ .....rccscscecseeeeee XSetWindowBorderPixmap 
report the display name (when XDisplayName 

request buffer and return the ......cs.cccccecseee XPending 

request buffer and wait for all .........ssss0s0e XSync 

request buffer (display all .........eesssecsssessees XFlush 

request that a top-level window ........... ««. XIconify Window 
request that a top-level WindOW .......ss0000 XReconfigureWM Window 
request that a top-level window ..........e000+ XWithdraw Window 
requests /use access CONEFOL .......e0c00008 «se XEnableAccessControl 
requests) /flush the request ......secsccsreseseee . XFlush 

Teset the SCTEEN SAVET or.eeoree0e Binsaeceracssmhtesore XResetScreenSaver 
FESIAES IN ATE BION ese ssosceseseasdscncavathescadesuoun XRectInRegion 

resource XrmQGetSearchResource: ....... XmmQGetSearchResource 
resource database XGetDefaullt: ..........000 XGetDefault 

TESOUTCE database. ........ecceee00 Raeessbiasasteenes ... XrmDestroy Database 
resource database /add XrmPutLineResource 
resource database /StOTE ..........cecrcsrseeesseses XrmPutResource 
resource database from command .......... XmmParseCommand 
resource database in a file .........0-00csesereeere XrmmPutFileDatabase 
resource from name and Class &$ .......0.0000 XmmGetResource 
(resource ID) associated With .........ccsessee XGContextFromGC 
TESOUFCE MANA LEN Facesaccoscasctusevasesssesesssvacscee Xmmfnitialize 

resource name and string ValUe .........0s000 XmmQPutStringResource 
resource name and ValUE ......0.00000 -.. XrmPutStringResource 
resource specification into a/ ......... we. XrmMQPutResource 
resource specification into a/ ......... .«. XrmPutResource 
resource specification tO a/ .......00008 «ee XrMQPutStringResource 
resource specification tO a/ ......0000+ «. XrmPutLineResource 
resource specification With/ .......... .«. XrmPutStringResource 
resource value using naMe and. .........000000 XmmQGetResource 
resources XKillClient: destroy ........s.00000e XKillClient 

resources are grabbed /keyboard XAllowEvents 

retrieve a database from a file ..........csese0 XmmGetFileDatabase 
retum a list of all Extensions ..........cc0rseees XListExtensions 

retum a list of children, ....... eesaatsTecs .»- XQueryTree 

retum a list of database levels ....... soe APMQGetSearchList 
retum a list of the available ........... «es XListFonts 

retum a new Colormap ID .......0.seseceeeseee0eee & COpyColormapAndFree 
retum an atom for a BIVEN a... +» XIntemAtom 

return data from a cut buffer ......000.. ssesvenee MEOtChBuffer 

return data from cut buffer 0 ........s.000000084 XFetchBytes 

retum information about a .....00.. es careneeaate XQueryFont 

return symbols for KeyCodes .....seccccesesssees XGetKeyboardMapping 
retum the current keyboard ......vsecscseesees . XGetInputFocus 

retum the next event in Queve/ .....s.ceereeeee XCheckTypedWindowEvent 
retum the next event in queue . XCheckTypedEvent 
retum the number of pending/ ..........s.s000 XPending 

return the owner Of a SelECtion ..........c00000 XGetSelectionOwner 
RGB values and closest ......... Retrisrerren «se X LOokupColor 

RGB values and flags for a/ ......ssseeeessesore . XQueryColor 

RGB values for an array Of ....ssvesssoesees ..» XQueryColors 

RGB values from ASCII color name ....... XParseColor 

RGB values from color name ....se.0e000 sone KLOOKupColor 

RGB values of a read/WTrite ...s.ssssssseee soe MOtoreNamedColor 
RGB values of a read/write/ ...... ssseevee KOLOreColor 

RGB values of read/Write/ .......ssesecssssseonee XStoreColors 
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XBell: 

a list of children, parent, and 
XRotate WindowProperties: 
XRotateBuffers: 

XSetFillRule: set the fill 

fif two regions have the 

to a window and/ XSaveContext: 
reset the screen 

set the parameters of the screen 
/uum the screen 

/get the current screen 

add a window to the client’s 

a subwindow from the client’s 

a window from the client’s 

the depths available on a given 
pointer to another point on the 
XActivateScreenSaver: activate 
XResetScreenSaver: reset the 

set the parameters of the 
XForceScreenSaver: tum the 
XGetScreenSaver: get the current 
new graphics context for a given 
get the current font 
XSetFontPath: set the font 
resource XrmQGetSearchResource: 
sent to a window XSelectInput: 
use the value of a 

retum the owner of a 

set the owner of a 

connection with the/ XNoOp: 
XSendEvent: 

select the event types to be 

/a resource specification with 
range of legal keycodes for a 
XGrabServer: grab the 

to X supported by Xlib and the 
pixmap formats for a given 

to exercise connection with the 
connect a client program to an X 
errors to be processed by the 

a client program from an X 
XQueryTextExtents: query the 
XQueryTextExtents16: query the 
XUngrabServer: release the 
/read keycode-keysym mapping from 
Xlib/ XSetAfterFunction: 
handler XSetErrorHandler: 

a graphics context XSetDashes: 
XPutPixel: 

property XSetWMHints: 
manager/ XSetWMProperties: 
property XSetWMClientMachine: 
XSetWMColormapWindows: 
property XSetWMProtocols: 
property XSetWMSizeHints: 
property XSetWMIconName: 

" -property. XSetWMName: 
XSetWMNomnalHints: 


_ Permuted Index 








ring the bell (Control G) .......sccssccsesescseeee XBell 

TOOt XQueryTree: retuM .......ve0v00 XQueryTree 

rotate properties in the/ XRotate WindowProperties 
rotate the cut buffers ..........csecoes XRotateBuffers 

tule in a graphics CONTEXt .......00000 XSetFillRule 

same size, offset, and shape ........+.+. XEqualRegion 

save a data value corresponding XSaveContext 
saver XResetScreenSave#: ...cccccccrcessecesoee XResetScreenSaver 
Saver XSetScreenGave#s: .orcecscccccscsesssessovees XSetScreenSaver 
SAVE ONION Offi: tesssvsscscnsacecactecssstacescnessdves XForceScreenSaver 
SAVET PATAMELETS .ccccssscscecsseesecscsessrsesesecseces XGetScreenSaver 
save-set XAddToSaveSet: ......ccsscssressoesees XAddToSaveSet 








Save-Set /add OF TEMOVE .ccscccorscssseecereseseees XChangeSaveSet 
SAVE-SEL /TEMOVE coccscscsorcccscescesseseresersrscense XRemoveFromSaveSet 
screen XListDepths: determine ........0000 XListDepths 

screen XWarpPointer: move the ........0.+00 XWarpPointer 

screen blanking ......scccscrscscssccssrsscssoereres XActivateScreenSaver 
SCKECMISAV OHA eraccseveccenseescssuensscecseacesenstaecsaves XResetScreenSaver 
screen saver XSetScreenSaver#: .......0.00 XSetScreenSaver 
SCTEEN SAVEF ON OF Off .....ccssscresssserecsoseensere XForceScreenSaver 
SCTEEN SAVEF PALAMELETS .....scsccccccerecssereseees XGetScreenSaver 
screen with the depth of the/ /a ............00 XCreateGC 

search path XGetFontPath: ...........cccscscee XGetFontPath 
Searchicpathiesrericsvecescoeteeeenvacssearsteecsoussduenebaey XSetFontPath 

search prepared list for a giVEN .......ececeeee XmmQGetSearchResource 
select the event types tO DE .......cccsccsssesenees XSelectinput 

selection XConvertSelection: ......... meni XConvertSelection 
selection XGetSelectionOwner: .........0++ XGetSelectionOwner 
selection XSetSelectionOwner: ............++ XSetSelectionOwner 
sent to a window XSelectInput: ...........0++ XSelectInput 

separate resource name and value ............ XrmPutStringResource 
Server /Oobtain the ..rcccccccsssssoscssesesssseserssees XDisplayKeycodes 
SOLVE Tacieosssreresetics sentitccyoeceeceasecescomeecestspaceteay XGrabServer 

server /a list of all extensions ............000000 XListExtensions 

server /obtain the supported ......s-s.00scsse000 XListPixmapFormats 
server XNoOp: send a NOOp ....ccssssesseesees XNoOp 

server XOpenDisplay: ...........0000+ XOpenDisplay 

server /wait for all events and ...........0-0000 XSync 

server and display /discOnncct ........0es000e0 XCloseDisplay 

server for string and font/ ..........cscscscsssessee XQueryTextExtents 
server for string and font/ ........sccsscsssesereres XQueryTextExtents16 
SETVET frOM Brad .ecccccresssessseoes poeatiesncncseeeere XUngrabServer 

SELVET INTO XID ..rervosscorsersvseseeseveees eavstiseseat XRefreshKeyboardMapping 
set a function called after alll ..........sssscsees XSetAfterFunction 

set a nonfatal error EVENE ......cscccsccssecssscores XSetErrorHandler 

set a pattern of line dashes in ..........ecssesesee XSetDashes 

set a pixel value in an iMage .........0cccceseees XPutPixel 

set a window manager hints ...........0cecer00 XSetWMHints 

set a window’s standard window ........+00+. XSetWMProperties 

set a window’s WM_CLIENT_MACHINE XSetWMClientMachine 
SCL AIWINAOW7S/ cbecxssaccsdhsccpseesesetasseoetsctetbese XSetWMColomapWindows 
set a window’s WM_PROTOCOLS ......... XSetWMProtocols 

set a window’s WM_SIZE_HINTS .......... XSetWMSizeHints 

set a window’s XA_WM_ICON_NAME XSetWMIconName 
set a window’s XA_WM_NAME ......00000 XSetWMName 

S€t A WINdOW’S/ ceisccsccscesscesssoecerseceressesecersess XSetWMNomnalHints 
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structure XSetRGBColormaps: 
create a window and 

context to the/ XSetRegion: 
graphics context XSetClipMask: 
modifiers/ XSetModifierMapping: 
manager /set the minimum 
properties XSetTextProperty: 

a read/write/ XStoreColor: 
read/write/ XStoreColors: 
colorcell by/ XStoreNamedColor: 
context XSetArcMode: 

attribute/ XSetWindowBackground: 
in a graphics/ XSetBackground: 
operation in a/ XSetFunction: 
graphics/ XSetClipOrigin: 
window XSetWindowColormap: 
graphics context XSetFont: 
context XSetFillRule: 

context XSetFillStyle: 

context XSetTile: 

XSetFontPath: 

logical function,/ XSetState: 

in a graphics/ XSetForeground: 
XSetGraphicsExposures: 
XSetInputFocus: 

in a/ XSetLineAttributes: 
XSetStandardProperties: 

a window’s icon XSetIconName: 
XSetSelectionOwner: 

saver XSetScreenSaver: 

context XSetPlaneMask: 
XSetPointerMapping: 

window in/ XSetNormalHints: 
zoomed window XSetZoomHints: 
XStringListToTextProperty: 
context XSetStipple: 

graphics/ XSetSubwindowMode: 
graphics context XSetTSOnigin: 
type/ XSetSizeHints: 
XA_WM_ICON_SIZE/ XSetIconSizes: 
a window XSetClassHint: 
(command line/ XSetCommand: 
property/ XSetTransientForHint: 
XChange WindowAttnibutes: 

have the same size, offset, and 

the fastest supported stipple 

the fastest supported fill tile 

a mapping of modifier keys 
keycodes to be used as modifiers 
map a window on top of its 
change the stacking order of 
XGetPixel: obtain a 

a drawable/ XCopyPlane: copy a 
cursor, tile, or stipple 

XResize Window: change a window’s 
XMoveResize Window: change the 
/change the window position, 
geometry/ /generate position and 
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set an XStandardColormap .....sscseseseesesees XSetRGBColormaps 
set attributes XCreateWindow: ....... «soe & Create Window 















set clip_mask of the graphics ........0ccecsesee XSetRegion 

set clip_mask pixMap it & sssscscessscscssesesees XSetClipMask 

set keycodes to be used aS ....vccsecessseesseeee XSetModifierMapping 
set of properties for the WindOW .........00000 XSetStandardProperties 
set one Of a WiNdOW’S tEXt ..sreccccsserssersseeeee XSetTextProperty 

set or change the RGB values off ..........00+ XStoreColor 

set or change the RGB values of ...........0+ XStoreColors 

set RGB values of a read/Write ........ec00e00e XStoreNamedColor 

set the arc mode in a graphics ......cccsesssere XSetArcMode 

set the background pixel value ..........ce0e0 XSetWindowBackground 
set the background pixel value ............0000 XSetBackground 

set the bitwise logical XSetFunction 

setithe Clip Orig tmiini talicssccsssocessccencsecosesssorece XSetClipOngin 

set the colormap attribute for a ........sccsceee XSetWindowColormap 
set the current font IN a .....cccosccscssscsescssesees XSetFont 

set the fill rule in a graphics XSetFillRule 

set the fill style in a graphics ..........cecese000 XSetFillStyle 

set the fill tile in a graphics ........ccsecsseserseee XSetTile 

set the font search path ....... pesceresneastoeeetene XSetFontPath 

set the foreground, background, ..... XSetState 

set the foreground pixel value ....... i" XSetForeground 

set the graphics_eXxposures/ ........0000 XSetGraphicsExposures 
set the keyboard focus window ....... XSetInputFocus 

set the line drawing components ..... XSetLineAttributes 

set the MinimuM set Off ........ccsrcrsereeececereee XSetStandardProperties 
set the name to be displayed in XSetIconName 

set the owner of a selection .........000 XSetSelectionOwner 


XSetScreenSaver 
XSetPlaneMask 


set the parameters of the screen 
set the plane mask in a graphics 
















set the pointer button mapping ........ XSetPointerMapping 
set the size hints property of a ......... XSetNormalHints 

set the size hints property of a ......... XSetZoomHints 

set the specified list Of/ c..........secessssesseeeses XString ListToTextProperty 
set the stipple in a grapNics .......ssceeesseeeseees XSetStipple 

set the subwindow mode in a XSetSubwindowMode 
set the tile/stipple Origin in @ ........00eseseseee XSetTSOrigin 

set the value of any property Of ..........0000 XSetSizeHints 

Set theivaltie/olithemcatcrercrcccecstectercteassesseeeeve XSetlIconSizes 

set the XA_WM_CLASS property of ...... XSetClassHint 

set the XA_WM_COMMAND atom ....... XSetCommand 

set the XA_WM_TRANSIENT_FOR ...... XSetTransientForHint 
S€t WINdOW ALtTIbULES ........ccccceccsererorsrecenes XChange WindowAttributes 
shape /determine if two regions .........ce00 XEqualRegion 

shape XQueryBestStipple: obtain ........... XQueryBestStipple 
shape XQueryBestTile: obtain ..........s00e00 XQueryBestTile 

(Shift, Control, etc.) /obtain ....csssssees ... XGetModifierMapping 
(Shift, Control, etc.) /Set. ..cccccorccscsseresscessess XSetModifierMapping 
siblings XMapRaised: ....cosecsessscsssssescesosees XMapRaised 

siblings XRestackWindOWS: ......ssecseseseees XRestack Windows 
single pixel value from an image .......000 XGetPixel 

single plane of a drawable into ........0ss0000 XCopyPlane 

size [the "best" supported ....c..ccecssssssseseses XQueryBestSize 

SIZOM  cscecrosvkensadtsnacsstersbostavenstty Robadteae nn ookieatees XResizeWindow 

size and position Of & WINdOW ....csseceseseeee XMoveResizeWindow 
size, border width, or stacking/ .......sscs00 XConfigureWindow 
siZe from standard WindOW ....s.0-vssessesesseee XParseGeometry 


~ 
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in/ XGetNormalHints: get the 
in/ XSetNormalHints: set the 
window XGetZoomHints: read the 
window XSetZoomHints: set the 
reduce or expand the 

ff two regions have the same 
get preferred icon 

get the closest supported cursor 
region XClipBox: generate the 
using quarks /store a resource 
XrmPutResource: store a resource 
using a quark/ /add a resource 
database /add a resource 
resource name/ /add a resource 
the RGB values and flags for a 
screen with the depth of the 

/ID) associated with the 
XTextProperty structure /set the 
/the next event that matches the 
Xlib function XFree: free 
/structure associated with the 

of the graphics context to the 
data associated with the 
structures that match the 

- /obtain a list of strings from a 
bottom child to the top of the 

top child to the bottom of the 
position, size, border width, or 
lower a window in the 

raise a window to the top of the 
down /circulate the 

XRestack Windows: change the 
XGetStandardColormap: get the 
XSetStandardColormap: change the 
/create a cursor from the 
/generate position and size from 
XSetWMProperties: set a window’s 
/property of a window in normal 
/property of a window in normal 
a bit vector for the current 
XSetStipple: set the 

/obtain the fastest supported 
supported cursor, tile, or 
XDestroyRegion: deallocate 
fanload a font and free 

file XrmPutFileDatabase: 

into a/ XrmQPutResource: 

into a resource/ XrmPutResource: 
XStoreBuffer: 

XStoreBytes: 

atom for a given property name 
convert a keysym symbol to a 
from standard window geometry 
metrics of a 16-bit character 
create a database from a 

convert a quark toa 

/geometry given user geometry 
/query the server for 


_ Permuted Index 














size hints property of a WindOW .......cese000 XGetNormalHints 

size hints property of a WindOW .......s.ss000 XSetNomnalHints 

size hints property of a zoomed XGetZoomHints 

size hints property of a zoomed ... XSetZoom Hints 

size of a region XShrinkRegion: ........0000 XShnnkRegion 

SiZe, Offset, and ShAPe .........cccscovrreesessereee XEqualRegion 

sizes XGetlcomSizes: ....e.sscomessscsssoseesseseeens XGetIconSizes 

sizes XQueryBestCursor: ....cz0000« XQueryBestCursor 
smallest rectangle enclosing a .... XChipBox 

specification into a database ....... XmQPutResource 
specification into a TESOUTCE/ .......ceeerecseeeee XrmPutResource 
specification to a database .......-..sssessseeers XmmQPutStringResource 
SPECIfICAtION tO A TESOUTCE «....orcscersessessseees XrmPutLineResource 
specification with Separate .........c0ceresseeee XmmPutStringResource 
specified colorcell /ObtAIN .........0eeesecsesseee XQueryColor 

specified drawable /for a given XCreateGC 

specified graphics CONtEXt .....cccssersssssesesees XGContextFromGC 
specified list of strings to aN ..........-.00-000e0 XStringListToTextProperty 
specified mask and WiINdOW ........s..csceseseee XWindowEvent 
specified memory allocated by an ........... XFree 

Specified PrOPETty ....r.ccccceccsecccccsssersrerscsseses XGetRGBColormaps 
specified region /set clip_mask XSetRegion 

specified string list in-memory XFreeStringList 
specified template /information ...........00 XGetVisuallInfo 
specified XTextProperty/ ........ccccscocsesessese XTextPropertyToStringList 


stacking order /circulate the XCirculateSubwindowsDown 











stacking order /circulate the XCirculateSubwindowsUp 
stacking order (the window XConfigureWindow 
stacking order XLowerWindow: .....+000000 XLowerWindow 
stacking order XRaise Window: ........ ... XRaiseWindow 
stacking order of children up or ..... ««. XCirculateSubwindows 
stacking order of siblings ..........000++. ... XRestack Windows 
standard colormap proper#ty ......0sccecresereseee XGetStandardColormap 
standard colormap PropEe#ty .........ccerecoeeee XSetStandardColormap 
Standard Cursor fONt .........ceccecscsssscosssnseeseee XCreateFontCursor 
standard window geometry string ........... XParseGeometry 
standard window manage? .........-.0008 es. XSetWMProperties 
state (not zoomed or iconified) .«. XGetNormalHints 

state (not zoomed or iconified) -«» XSetNomnalHints 

state of the keyboard /obtain ...........0.cs00 XQueryKeymap 

stipple in a graphics CONtEXE .........scsseceseres XSetStipple 
Stipplesshapes stesvistsssnscensecesscetcssenstessahsczeses® XQueryBestStipple 





stipple size /the “best” XQueryBestSize 





storage associated with a region +. XDestroyRegion 
storage for the font structure ......... .«. XFreeFont 

store a resource database in a ..... .. XrmPutFileDatabase 
Store a FESOUTCE SPECIFICATION ........ccececeeee XmmQPutResource 
SLOTE A TESOUTCE SPECIFICATION .........sceccceee XmmPutResource 
store data in a cut buffer XStoreBuffer 





store data in cut buffer 0 XStoreBytes 





string XInternAtom: retum an ....... ... XIntemAtom 

string XKeysymToString: .........000+ ... XKeysym ToString 
string /position and SiZe .......... ... XParseGeometry 

string /for string and font .........s.cscessssseeess XQueryTextExtents16 
string XrmGetStringDatabase: .........s0s000 XrmGetString Database 
string XrmQuarkToString: ......ccccccssessresee XmmQuarkToString 
string and default geOMetry. ........-.esssersere XGeometry 

String and font MELtTICS .....ccccsscsosessssesssesees XQueryTextExtents 
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XTextExtents: get 
16-bit/ /query the server for 
16-bit/ XTextExtents16: get 

/rebind a keysym to a 
XDrawString: draw an 8-bit text 
/map a key event to ASCII 
associated with the specified 
metrics of a 16-bit character 

in pixels of an 8-bit character 

in pixels of a 16-bit character 

its atom XGetAtomName: get a 
quark list /convert a key 
/convert a keysym name 
XmmString ToQuark: convert a 
/convert a key 

using a quark resource name and 
draw two-byte text 

XDrawText: draw 8-bit polytext 


draw 16-bit polytext 


resource from name and class as 
XTextProperty/ /obtain a list of 
/set the specified list of 

allocate an XClassHint 

allocate an XIconSize 

allocate an XSizeHints 

/allocate an XStandardColormap 
allocate an XWMHints 

allocate memory for an XImage 
an entry from an XModifierKeymap 
and free storage for the font 

free a keyboard modifier mapping 
new entry to an XModifierKeymap 
load a font and fill information 
corresponding to a keycode in 

a keyboard modifier mapping 

set an XStandardColormap 

of strings to an XTextProperty 
from a specified XTextProperty 
/obtain the XStandardColormap 
/find the visual information 
XSetFillStyle: set the fill 
XSubimage: create a 
XSubtractRegion: 
XChangeSaveSet: add or remove a 
XSetSubwindowMode: set the 
and destroy a window and all 
XUnmapSubwindows: unmap all 
XDestroySubwindows: destroy all 
XMapSubwindows: map all 
/change the keyboard preferences 
/a list of all extensions to X 

/get the closest 

stipple/ /obtain the "best" 

/obtain the fastest 
XListPixmapFormats: obtain the 
/obtain the fastest 

/convert a keysym 
XGetKeyboardMapping: return 
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string and font metrics locally .......... soseseee X LEXtEXtents 



























string and font metrics Of & .........00.000000000008 XQueryTextExtents 16 
string and font metrics Of a .......0000 ... X TextExtents 16 

string for client .......00+ paoasedeacaveseersve ee XRebindKeysym 

string, foreground only .........0000000 we X Drawstring 

String, keysym, and/ .........0sseevsveeees .- XLookupString 

string list Ahe in-memory data ...... soe XFreeString List 

string, locally /string and font .........0.0. sooo X LEXtExtents 16 

string, locally /get the Width ...........0sessssee XTextWidth 

string, locally /get the Width ...........sssesese0 XTextWidth16 

string name for a property given .....00s.... XGetAtomName 

string to a binding list and @ .........00000 «eee APMString loBinding QuarkList 
StFINg tO a KEYSYM urseccrcscccoessessees XStringToKeysym 

String to a quark ......0000 XmmStringToQuark 

String to a quark LiSt .......0.cereeereees XmmString ToQuarkList 
string value /to a database XmmQPutStringResource 
Strings XDrawString16: .........ccecssecsererere XDrawString 16 

SUTINZS ...ccccccssosreseees aennsttesectverseaceatvescdvaseseee XDrawText 

Strings XDrawText16: .....cccrorsssossccsesereeee XDrawTextl6 

strings XrmGetResource: get a .......0cceee XmmGetResource 

Strings from a specified ...........000cveeereeeseeee XTextPropertyToString List 
strings to an XTextProperty/ .......c.c.cecesesees XStringListToTextProperty 
structure XA]locClassHint: .......cesssssssseee XAllocClassHint 

structure XALOcICONSIZE: ........00ceceeeeeeeeeee XAllocIconSize 

structure XAllocSizeHints: ..........00000eseeee XAllocSizeHints 

SUTUIGUUINE: (Gdids cesteerahsaitseeacesubeteastesesedesadcctasetee XAllocStandardColormap 
structure XATOCWMHiINES: ......c.cecescsssesees XAllocWMHints 

structure XCreatelmage: ........secccccccscssssese XCreateImage 

structure /delete ...........000ccreseseees XDeleteModifiermapEntry 
structure /unload a font XFreeFont 

structure /destroy and .........000000 XFreeModifiermap 
Structure /Addiays..cscssccssssecswcccovesersceseceseseaces XInsertModifiermapEntry 
structure XLoadQueryFont: .......csccesesereee XLoadQueryFont 

structure /get the keysym XLookupKeysym 

StIUCtiITen/ Create veccusisetecssaceucceotercttsnssteesscten XNewModifiermap 
structure XSetRGBColonmaps: ..........0000 XSetRGBColormaps 
structure /the specified list ..........c0csssesseee XStringListToTextProperty 
structure /a list Of Strings ......cccceescsessese XTextPropertyToStringList 
structure associated with the/ .........sssssee XGetRGBColormaps 
structures that match the/ XGetVisualInfo 

style in a graphics CONLEXE ...ccerscseees soos MOCtFINStyle 

subimage from part of an image .........0000 XSubImage 

subtract one region from another ........0000 XSubtractRegion 
subwindow from the Client’s/ ....c.sssesesseee XChangeSaveSet 
subwindow mode in a graphics/ .........s0000 XSetSubwindowMode 
SUDWINdOWS. /UNMAP .....sesesserervseensensessesers XDestroyWindow 
subwindows of a given WindOW .........ss0+0 XUnmapSubwindows 
subwindows of a WindOW .....sscssscsesscsessseee XDestroySubwindows 
SUbWindows Of WINdOW .sssscccesscssssseeeseeee XMapSubwindows 

SUCH as Key CLICK sscscccsresssvsssererecsseeres «+» XChangeKeyboardControl 
supported by Xlib and the server ..... ... XListExtensions 

SUPPOTted CUTLSOF SIZES ...rersrsrverereeerees ««« XQueryBestCursor 
supported cursor, tile, or ........ se XQueryBestSize 
supported fill tile shape ......sssssssessesees se XQueryBestTile 

supported pixmap formats for a/ ........0.0. XListPixmapFormats 
supported stipple shape .......ssssesssessssessees .- XQueryBestStipple 
SYMbOI tO @ SUTIN ..rccccoscrssccssscsssrsrvees areestie XKeysymToString 
Symbols for keyCOdes ....sscossrsssessssessssseseees XGetKeyboardMapping 
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XSynchronize: enable or disable 
another /change the coordinate 
an entry from an association 
allocated for an association 
obtain data from an association 
an entry in an association 

create a new association 

that match the specified 

/draw 8-bit image 

/draw 16-bit image 

/read one of a window’s 

/set one of a window’s 
XDrawString: draw an 8-bit 
XDrawString 16: draw two-byte 
border /change a window border 
/change the background 
XSetTile: set the fill 

the "best" supported cursor, 

the fastest supported fill 
graphics/ XSetTSOrigin: set the 
stacking order /circulate the 
XMapRaised: map a window on 
{the bottom child to the 

/raise a window to the 

XIconify Window: request that a 
/request that a 

X Withdraw Window: request that a 
values from ASCII color name or 
auto-repeat/ XAutoRepeatOff: 
keys XAutoRepeatOn: 
XForceScreenSaver: 

/create a cursor from 
XDrawLine: draw a line between 
compute the intersection of 
compute the union of 

the union and intersection of 
XEqualRegion: determine if 
XDrawString 16: draw 

entry for a given window and 
window /obtain the atom 

the next event in queue matching 
in queue that matches event 

fo a window and context 

get the next event of any 

/read any property of 

/set the value of any property of 
XSelectInput: select the event 
default if/ XUninstallColormap: 
/the difference between the 
XUnionRegion: compute the 
XUnloadFont: 

for the font/ XFreeFont: 
XUnmapWindow: 

window XUnmapSubwindows: 
all subwindows. XDestroy Window: 
XCreateSimple Window: create an 
/calculate window geometry given 
/specification to a database 


Permuted Index 


synchronization for debugging .....-..z.0000 XSynchronize 







system from One WiNdOW tO ..cccocscccsesrseees XTranslateCoordinates 
table. XDeleteAssoc: delete .........-.scececeee XDeleteAssoc 

table. /free the MEMOTY rerecsccserrsesserscereee XDestroyAssocTable 
table XLOOKUPASSOC: .....ecscsssescesoeeersrecseee XLookUpAssoc 

table XMakeAssoc: Create .cossesssssessnseesnee XMakeAssoc 

table (X10) XCreateAssocTable: .......... .e. &CreateAssocTable 
template /information Structures .........00006 XGetVisualInfo 

TEX ChAVACICHS etecenicanssssscncesesnenscensiascndonerees XDrawImageString 
texticharactens'cé.ce caveatssscssancsessstsateardoneneshe XDrawImageString 16 

















TEXt PropPeIbie sraasciskevsesetratesetbesctsssacesssnviestase XGetTextProperty 

LEXL PFOPETHIES ......e0000e iSpetecatesesranieusesstatraciss XSetTextProperty 

text string, foreground Only ........0cecseeeeeee XDrawString 

text strings ....... apaschasseccesntnncneeenenst seat gaperies XDrawString 16 

tile attribute and repaint the ...........000seceree XSetWindowBorderPixmap 
tile attribute of a WINdOW .esssssecssssssveseeseees XSetWindowBackgroundPixmap 
tile in a graphics CONTEXE ........secesseessseesssees XSetTile 

tile, or stipple size /obtain ........cccsescseeeees XQueryBestSize 

tile shape /ObtAIN .......scereceseesesverssesessesesees XQueryBestTile 

tile/stipple Origin in @ ..........0.00sscecssereeseeee XSetTSOrigin 

top child to the bottom of the .........sesee0 XCirculateSubwindowsUp 
top Of its SIb]INGS .........crcsesroecscsessesesersevere XMapRaised 

top of the stacking Oder ........cssssesecssseeesee XCirculateSubwindowsDown 
top of the stacking OTder .......0esssssrsseseseeee XRaise Window 

top-level window be iconified ..........+0s0000 XIconify Window 

top-level window be reconfigured ......... .. XReconfigureWM Window 
top-level window be withdrawn ..........s00 XWithdraw Window 
translate hexadecimal value /RGB .......... XParseColor 

tum off the keyboard .......... seatetasbendtest ahah XAutoRepeatOff 

tum on the keyboard auto-repeat ........0000 XAutoRepeatOn 

tum the screen saver on Or Off ...........000e00+ XForceScreenSaver 

two bitMapS ........0000 esebsyesaed opts ae leassahoseeiees XCreatePixmapCursor 

TWO POMS Haceesidiesdbaieetizcdctontcosccendeveascaverestes XDrawLine 

two regions XIntersectRegion: ..........0.0 XIntersectRegion 

two regions XUnionReEgion: ........ccceeeeee XUnionRegion 

two regions /difference between ........ soos XXOFREGion 

two regions have the same SiZe,/ .......0ss000 XEqualRegion 

tWO-byte LEXE SIFINGS ..cccrccssccovesesesscsesesseseee XDrawString 16 

type /delete a CONTEXE .......reccccscecsssrseneeseees XDeleteContext 

type and property format for a XGetWindowProperty 

type and Window /TetUI ..u.esoorssssesssssseseees XCheckTypedWindowEvent 
type; don’t wait /the next eVENt ......sss000 XCheckTypedEvent 

type (not graphics CONTEXt) .....cccsecssecseeees XSaveContext 

type or window XNextEvent: ........ccssscee XNextEvent 

type XA_SIZE_HINTS. ...ssssssscsosssssssesseseee XGetSizeHints 

type XA_SIZE_HINTS. ..sssssssvsssssessssecenes XSetSizeHints 

types to be sent to & WINdOW nssrcccsorseseres XSelectInput 

uninstall a colormap; install .........00000seee00 XUninstallColormap 


union and intersection of two/ XXorRegion 
union of two regions XUnionRegion 
unload.a fontinicatilissnctieatsinstiesteeteens XUnloadFont 


unload a font and free storage XFreeFont 

unmap a window ........ Aosbtoeperekanencncatced «se. & Unmap Window 
unmap all subwindows of a given ........0 XUnmapSubwindows 
unmap and destroy a window and. .......00. XDestroyWindow 
unmapped InputOutput window ........00000 XCreateSimple Window 
user geometry string and default ............ XGeometry 

using a quark resource name and/ ............ XMmQPutStringResource 
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/get a resource value 
specification into a database 
name or translate hexadecimal 
with separate resource name and 
a quark resource name and string 
/change a window border pixel 
/set the background pixel 

and/ XSaveContext: save a data 
XGetPixel: obtain a single pixel 
XGetDefault: extract an option 
/set the background pixel 

/set the foreground pixel 

a constant value to every pixel 
XPutPixel: set a pixel 
XConvertSelection: use the 
XSetSizeHints: set the 

property XSetIconSizes: set the 
image XAddPixel: add a constant 


XrmQGetResource: get a resource, 


with depth, applying pixel 
XLookupColor: get database RGB 
XQueryColor: obtain the RGB 
XQueryColors: obtain RGB 
XParseColor: look up RGB 
closest hardware-supported RGB 
by/ XStoreNamedColor: set RGB 
entry to/ /set or change the RGB 
to the/ /set or change the RGB 
the/ XQueryKeymap: obtain a bit 
draw a polyline or curve between 
a filled polygon or curve from 

’ obtain the visual ID from a 
XVisualIDFrom Visual: obtain the 
that/ XGetVisualInfo: find the 
XMatch Visuallnfo: obtain the 
event that matches mask; don’t 
that matches event type; don’t 
window and passed mask; don’t 
to/ /flush the request buffer and 
predicate procedure XIfEvent: 
fails) /report the display name 
character/ XTextWidth 16: get the 
character/ XTextWidth: get the 
/change the border 

window position, size, border 

a property associated with a 
event in queue matching type and 
clear a rectangular area in a 
XClearWindow: clear an entire 
create an unmapped InputOutput 
assign a cursor to a 

destroy all subwindows of a 

the XA_WM_CLASS property of a 
the current keyboard focus 
property of a 

obtain the current attributes of 
type and property format for a 
size hints property of a zoomed 
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aici XmmQGetResource 
itis XrmQPutResource 


using name and class as quarks 
using quarks /store a resource ...... 


















value /values from ASCII color .......s.000e+ XParseColor 

value /a resource specification .........0.c-000 XrmPutStringResource 
value /to a database USING ........cecereseeceseee XmmQPutStringResource 
value attribute and repaint the/ .......-..s0se0 XSetWindowBorder 
value attribute of a WiINdOW .......cccccccsseeee XSetWindowBackground 
value corresponding to a WiINdOW ses-z-se0 XSaveContext 

value from an image 

value from the resource database .........00 XGetDefault 

value in a graphics CONTEXE .......sesecseseeesee XSetBackground 

value in a graphics CONtEXt .......000 XSetForeground 

value in an image /add ........ccceee0 XAddPixel 

Valle iN AN IMAZE sesscscesesccecscesesesese XPutPixel 

value Of a Selection ..........0000e0eeresee XConvertSelection 
value of any property of type/ XSetSizeHints 

value of the XA_WM_ICON_SIZE ......... XSetIconSizes 

value to every pixel value in an ...........000 XAddPixel 

value using name and class as/ .........ssces00 XmQGetResource 
values /drawable into a drawable ............ XCopyPlane 

Values and C1OSESt/ .....rccccoscsseessesescererescssere XLookupColor 

values and flags for a specified/ ...........000 XQueryColor 

values for an array Off ........seccrsssesressssseeers XQueryColors 

values from ASCII color name 01/ .........+ XParseColor 

values from color name /and. .........000000008 XLookupColor 

values of a read/write colorcell ...........000 XStoreNamedColor 
values of a read/write colormap .........:000 XStoreColor 

values of read/write colorcells ............00000 XStoreColors 

vector for the current state Of .........ss0v000 XQueryKeymap 

vertex list (from X10) XDraw: ........cceeee XDraw 

vertex list (from X10) /draw .........0000c00000 XDrawFilled 

Visual X VisualIDFrom Visual: ............000 XVisualIDFrom Visual 
visual ID from a Vistial .......s.cecssecseseseseeoee XVisualIDFrom Visual 
visual information structures XGetVisualInfo 

visual information that matches/ ..........00+. XMatch VisualInfo 

wait /remoOve the NEXt .....ccccccsccvsssessrcsscssees XCheckMaskEvent 
wait /the next event in QUeUE .........s00ceeee0 XCheckTypedEvent 
wait /event matching both passed ............ XCheck WindowEvent 
wait for all events and EFfOFs .....ssrecceseseee XSync 

wait for event matched in ......... XIfEvent 

(when connection to a display XDisplayName 

width in pixels Of a 16-bit ........ccccecccsceeeee XTextWidth16 

width in pixels of an 8-bit ......... XTextWidth 

Width of 2 WINdOW .vsesesescseseeeeees XSetWindowBorderWidth 
width, or stacking Order [the ...ssccssscesssssee XConfigure Window 
window XChangeProperty: change ........ XChangeProperty 
window /retum the next XCheckTypedWindowEvent 
window XClearArea: ..s..evsseeoee XClearArea 

WINdOW secscsoseees dtc etedsuecscsrosctateatenscottarestane XClearWindow 
window XCreateSimpleWindow: ............ XCreateSimpleWindow 
Window XDefineCursor: ......ccscssecrsessseees XDefineCursor 
window XDestroySubwindows: ........0000 XDestroySubwindows 
window XGetClassHint: get .......sssssevscees XGetClassHint 
window XGetInputFocus: retum .........000 XGetInputFocus 
window /the XA_WM_TRANSIENT_FOR XGetTransientForHint 
window XGetWindowAttributes: ........0+ XGetWindowAttributes 
Window /obtain the atom ......cssssssesssssssesaes XGetWindowProperty 
window XGetZoomHints: read the ......... XGetZoomHints 
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get the property list for a 

map all subwindows of 
XMapWindow: map a 

the size and position of a 
XMoveWindow: move a 

the next event of any type or 

the event types to be sent to a 

the XA_WM_CLASS property of a 
set the keyboard focus 

property for a 

pixel value attribute of a 
background tile attribute of a 
change the border width of a 

set the colormap attribute for a 
size hints property of a zoomed 
disassociate a cursor from a 
unmap all subwindows of a given 
XUnmapWindow: unmap a 
matches the specified mask and 
/anmap and destroy a 

/a data value corresponding to a 
Ansert a window between another 
/next event matching both passed 
XCreate Window: create a 

a context entry for a given 
XChange WindowAttributes: set 
/request that a top-level 

/request that a top-level 

/request that a top-level 

and/ XReparentWindow: insert a 
XSetWindowBorder: change a 
XSetWindowBorderPixmap: change a 
XStoreName: assign a name to a 
XRemoveFromSaveSet: remove a 
geometry/ XGeometry: calculate 
position and size from standard 
/get the size hints property of a 
/set the size hints property of a 
XLowerWindow: lower a 

set of properties for the 

a name to a window for the 
XGetWMHints: read the 
XSetWMHints: set a 

/set a window’s standard 
XMapRaised: map a 

XPutImage: draw an image on a 
XConfigureWindow: change the 
XDeleteProperty: delete a 

the coordinate system from one 
XAddToSaveSet: add a 

stacking/ XRaise Window: raise a 
XWMGeometry: obtain a 

the name to be displayed in a 
property) XFetchName: get a 
XResize Window: change a 

_ XSetWMProperties: set a 
XGetTextProperty: read one of a 
XSetTextProperty: set one of a 


Permuted Index 


window XListProperties: ....... (bedtossdhotcains XListProperties 
window XMapSubwindows: .......s.0-00csee XMapSubwindows 
ase XMapWindow 
WINdOW [ChAaNgZe ...scecccscsoscsccssoessssseecerereseees XMoveResize Window 
WATLA OW Pe ccccassatetssSrosodeoteeatastesuvasetethtesosketvaaty XMoveWindow 














window XNextEvent: get «cesses XNextEvent 

window XSelectInput: select XSelectInput 

window XSetClassHint: set .......0++ XSetClassHint 

window XSetInputFocus: .......sseserseererees XSetInputFocus 

window /the XA_WM_TRANSIENT_FOR XSetTransientForHint 
window /set the background ..v-v0»10000000000 XSetWindowBackground 
WINdOW /Change the .......cccesseccssesseversceseees XSetWindowBackgroundPixmap 
window XSetWindowBorderWidth: ....... XSetWindowBorderWidth 
window XSetWindowColommap: ....-...00 XSetWindowColormap 
window XSetZoomHints: set the .........0. XSetZoomHints 

window XUndefineCursor: ....sscsssccsseseseee XUndefineCursor 

window XUnmapSubwindows: .......s..008 XUnmapSubwindows 
WIDGOW, Sesteseratecssiptoetectetaocobsersanes sone seatbinotce> XUnmapWindow 

window /the next event that ...crsesssssseeee XWindowEvent 

window and all subWindowS. .........00000se0 XDestroy Window 

window and context type (NOt/ ..........0ses00 XSaveContext 

WiNdOW and its PaLENt ....c.crersecsceeeerecoseseners XReparentWindow 
window and passed mask; don’t/ .......0s00+. XCheck WindowEvent 
window and set attributes ........sccsessesseseees XCreate Window 

window and type /delete XDeleteContext 

window attributes .......... XChange WindowAttributes 
window be iconified ........00ses0s0 XIconifyWindow 

window be reconfigured XReconfigureWM Window 
window be Withdrawn ........scccscsssseessseesees XWithdraw Window 
window between another window ........... XReparentWindow 
window border pixel value/ ...........000sss000 XSetWindowBorder 
window border tile attribute and/ ........... XSetWindowBorderPixmap 
windew for the window manager ........+« XStoreName 

window from the client’s/ ........ssssssssssseee XRemoveFromSaveSet 
window geometry given user XGeometry 

window geometry string /generate .......... XParseGeometry 


window in normal state (not/ XGetNommalHints 





window in normal state (not/ XSetNormalHints 
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—Xlib — Function Group Introduction 


This page describes the format of each reference page in this volume. 


Name 
XFunctionName — brief description of the function. 


Synopsis 
The Synopsis section presents the calling syntax for the routine, including the declarations of 
the arguments and return type. For example: 


returntype XFunctionName(argl, arg2, arg3); 
typel argl; 
type2 *arg2; /* RETURN */ ; 
type3 *arg3; /* SEND and RETURN */ 


The return type Status is of type int; it returns either True or False to indicate whether 
the routine was successful. 


Arguments 
The Arguments section describes each of the arguments used by the function. There are three 
sorts of arguments: arguments that specify data to the function, arguments that return data from 
the function, and arguments that do both. An example of each type is shown below: 


argl Specifies information for XFunctionName. The description of arguments that 
pass data to the function always begins with the word “Specifies,” as shown in this 
example. 


arg2 Returns a pointer to data to be filled in by XFunctionName. The description of 
arguments that return data from the function always begins with the word 
“Returns.” 


arg3 Specifies information for XFunct ionName, and returns data from the function. 
The description of arguments that both pass data to the function and return data 
from the function uses both the words “Specifies” and “Returns.” 


Availability 
The Availability section specifies that a given function is only available in Release 4 and later 
releases. If there is no Availability section, the function is available prior to Release 4. 


Description 
The Description section describes what the function does, what it returns, and what events or 
side-effects it causes. It also contains miscellaneous information such as examples of usage, 
special error cases, and pointers to related information in both volumes of this manual. 


Structures 


The Structures section contains the C definitions of the X-specific data types used by 
-FunctionName as arguments or return values. It also contains definitions of important con- 
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stants used by the function. Additional structures not shown can be found in Appendix F, 
Structure Reference. 


Errors 
The general description of the error types is contained in Appendix B, Error Messages and Pro- 
tocol Requests. Some functions generate errors due to function-specific interpretation of argu- 
ments. Where appropriate, these function-specific causes have been listed along with the error 
event types they generate. 


Related Commands 


The Related Commands section lists the Xlib functions and macros related to X¥Function- 
Name. 
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xUP ae ett Savor ) XActivateScreenSaver 


Name ‘ 
XActivateScreenSaver — activate screen blanking. 


Synopsis 
XActivateScreenSaver (display) 
Display *display; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 


Description 
XActivateScreenSaver turns on the screen saver using the parameters set with xSet- 
ScreenSaver. The screen saver blanks the screen or makes random changes to the display 
in order to save the phosphors from burnout when the screen is left unattended for an extended 
period of time. The interval that the server will wait before starting screen save activity can be 
set with XSet ScreenSaver. Exactly how the screen saver works is server-dependent. 


For more information on the screen saver, see Volume One, Chapter 13, Other Programming 
Techniques. 


Related Commands 
XForceScreenSaver, XGetScreenSaver, XResetScreenSaver, XSetScreen- 
Saver. 
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Name 
XAddHost — add a host to the access control list. 


Synopsis 
XAddHost (display, host) 
Display *display; 
XHostAddress *hose; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
host Specifies the network address of the host machine to be added. 
Description 


XAddHost adds the specified host to the access control list for the server specified by dis- 
play. The access control list is a primitive security feature that allows access to the server 
only by other machines listed in a file on the machine running the server. On UNIX-based sys- 
tems, this file is called /etc/X? hosts, where ? is the number of the server. 


The application that calls XAddHost and the server whose list is being updated must be run- 
ning on the same host machine. 


The address data must be a valid address for the type of network in which the server oper- 
ates, as specified in the family member. Internet, DECnet and ChaosNet networks are cur- 
rently supported. 


For TCP/IP, the address should be in network byte order. For the DECnet family, the server 
performs no automatic swapping on the address bytes. A Phase IV address is two bytes long. 
The first byte contains the least significant eight bits of the node number. The second byte con- 
tains the most significant two bits of the node number in the least significant two bits of the 
byte, and the area in the most significant six bits of the byte. 


For more information on access control, see Volume One, Chapter 13, Other Programming 
Techniques. 


Structures 
typedef struct { 
int family; /* for example FamilyInternet */ 
int length; /* length of address, in bytes */ 
char *address; /* pointer to where to find the bytes */ 
} XHostAddress; 


/* The following constants for family member */ 





#define FamilyInternet 0 

#define FamilyDECnet iL 

#define FamilyChaos 2 
Errors 

BadAccess 

BadValue 
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Related Commands . ; 
XAddHosts, XDisableAccessControl, XEnableAccessControl, XListHosts, 
XRemoveHost, XRemoveHosts, XSetAccessControl. 
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Name 
XAddHosts — add multiple hosts to the access control list. 


Synopsis 
XAddHosts (display, hosts, num_hosts) 
Display *display; 
XHostAddress *hosts; 
int num_hosts; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
hosts Specifies each host that is to be added. 


num_hosts Specifies the number of hosts that are to be added. 


Description 
XAddHosts adds each specified host to the access control list for the server specified by dis- 
play. The access control list is a primitive security feature that allows access to the server 
only by other machines listed in a file on the machine running the server. On UNIX systems, 
this file is /etc/X? hosts, where ? is the number of the display. 


The application that calls XAddHosta and the server whose list is being updated must be run- 
ning on the same host machine. 


The address data must be a valid address for the type of network in which the server oper- 
ates, as specified by the family member. Internet, DECnet and ChaosNet networks are cur- 
rently supported. 


For TCP/IP, the address should be in network byte order. For the DECnet family, the server 
performs no automatic swapping on the address bytes. A Phase IV address is two bytes long. 
The first byte contains the least significant eight bits of the node number. The second byte con- 
tains the most significant two bits of the node number in the least significant two bits of the 
byte, and the area in the most significant six bits of the byte. 


For more information on access control, see Volume One, Chapter 13, Other Programming 


Techniques. 
Structures 
typedef struct { 
int family; /* for example Family Internet */ 
int length; /* length of address, in bytes */ 
char *address; /* pointer to where to find the bytes */ 


} XHostAddress; 


/* The following constants for family member */ 


#define FamilyInternet 0 
#define FamilyDECnet 1 
#define FamilyChaos 2 
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Errors 
BadAccess 
BadValue 


Related Commands 
XAddHost, XDisableAccessControl, XEnableAccessControl, XListHosts, 
XRemoveHost, XRemoveHosts, XSetAccessControl. 
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Name 
XAddPixel — add a constant value to every pixel value in an image. 


Synopsis 
XAddPixel (ximage, value) 
XImage *ximage; 
unsigned long value; 


Arguments 
ximage Specifies a pointer to the image to be modified. 
value Specifies the constant value that is to be added. Valid pixel value ranges 
depend on the visual used to create the image. If this value added to the 
existing value causes an overflow, extra bits in the result are truncated. 
Description 


XAddPixel adds a constant value to every pixel value in an image. This function is useful 
when you have a base pixel value derived from the allocation of color resources and need to 
manipulate an image so that the pixel values are in the same range. 


For more information on images, see Volume One, Chapter 6, Drawing Graphics and Text. 


Structures 
typedef struct XImage { 
' int width, height; /* size of image */ 
int xoffset; /* number of pixels offset in X direction */ 
int format; /* XYBitmap, XYPixmap, ZPixmap */ 
char *data; /* pointer to image data */ 
int byte order; /* data byte order, LSBFirst, MSBFirst */ 
int bitmap unit; /* quantity: Of scan line «8, 26,. S2.%/ 
int bitmap bit order; /* LSBFirst, MSBFirst */ 
int bitmap pad; /* 8, 16, 32 either XY or ZPixmap */ 
int depth; /* depth of image */ 
SUC M NOVAS se OS tae eT ip /* accelerator to next line */ 
Tinie OHsuis mS amo Ie lyr /* bits per pixel (ZPixmap) */ 
unsigned long red mask; /* bits in z arrangment */ 


unsigned long green_mask; 
unsigned long blue mask; 


char *obdata; /* hook for object routines to hang on */ 
Struck tuncs: { /* image manipulation routines */ 

Struct ~ximage * (“create image) (); 

int (*destroy image) (); 


unsigned long (*get pixel) (); 
int + pucmpi xed.) ())), 
struct XImage *(*sub image) (); 
inte (Faddsoasxeh) i()i, 
peek 

} XImage; 
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Related Commands 
ImageByteOrder, XCreateImage, XDest royImage, XGet Image, XGetPixel, 
XGet SubImage, XPut Image, XPutPixel, XSubImage. 
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Name 
XAddToSaveSet — add a window to the client’s save-set. 


Synopsis 
XAddToSaveSet (display, w) 
Display *display; 
Window w; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
Ww Specifies the ID of the window you want to add to the client’s save-set. 
Description 


XAddToSaveSet adds the specified window to the client’s save-set. 


The save-set is a safety net for windows that have been reparented by the window manager, 
usually to provide a titlebar or other decorations for each application. When the window man- 
ager dies unexpectedly, the windows in the save-set are reparented to their closest living ances- 
tor, so that they remain alive. See Volume One, Chapter 13, Other Programming Techniques, 
for more information about save-sets. 


Use XRemoveFromSaveSet to remove a window from the client’s save-set. 


Errors. 
BadMatch w not created by some other client. 


BadWindow 


Related Commands 
XChangeSaveSet, XRemoveFromSaveSet. 
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Name : 
XAllocClassHint — allocate an XClassHint structure. 


Synopsis 
XClassHint *XAllocClassHint () 


Availability 
Release 4 and later. 


Description 
XAllocClassHint allocates and returns a pointer to an XClassHint structure, for use in 
calling XSet WMP roperties, XGetClassHint, or XSetClassHint. Note that the 
pointer fields in the XClassHint structure are initially set to NULL. If-insufficient memory is 
available, XAllocClassHint returns NULL. To free the memory allocated to this structure, 
use XF ree. 


The purpose of this function is to avoid compiled-in structure sizes, so that object files will be 
binary compatible with later releases that may have new members added to structures. 


For more information, see Volume One, Chapter 10, Jnterclient Communication. 


Structures 
typedef struct ‘{ 
char *res_name; 
char *res' class; 
} XClassHint; 


Related Commands 
XGetClassHint, XSetClassHint, XSetWMProperties. 


Xlib Reference Manual , 43 


XAllocColor Xlib — Color Cells— 


Name 
XAllocColor — allocate a read-only colormap cell with closest hardware-supported color. 


Synopsis 
Status XAlLlocColor (display, cmap, .colorcell def) 
Display *display; 
Colormap cmap; 
XColor *colorcell_def; /* SENDs and RETURNs */ 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 


cmap Specifies the ID of the colormap in which the colorcell is to be allocated. 


eolorcel!] der 
Specifies desired RGB values, and also returns the pixel value and the RGB val- 
ues actually used in the colormap. 


Description 
XAllocColor returns in the XColor structure the pixel value of a read-only (shareable) 
colorcell with the closest RGB values available in cmap. XAllocColor also returns the red, 
green, and blue values actually used. 


If the display hardware has an immutable hardware colormap, the entire colormap will be read- 
only, and the closest cell that exists will be returned. Otherwise, the colormap is read/write, 
and may have some read/write cells, some read-only cells, and some unallocated cells. If a 
read-only cell exists that matches the requested RGB values, that cell is returned. If no match- 
ing cell exists but there are unallocated cells, a cell is allocated to match the specified RGB val- 
ues. If no matching cell exists and there are no unallocated cells, XAllocColor returns a 
Status of zero (in read/write colormaps, it does not return the closest available read-only 
colorcell that has already been allocated). If it succeeds, XAllocColor returns nonzero. 


Note that colorcell_def stores both the requested color when XAllocColor is called 
and the result when XAllocColor returns. 


XAllocColor does not use or affect the flags member of the XColor structure. 


For more information, see Volume One, Chapter 7, Color. 


Structures 
typedef struct { 
unsigned long pixel; 
unsigned short red, green, blue; 
char flags; /* DoRed, DoGreen, DoBlue */ 
char pad; 
} “XCollon, 


Errors 
BadColormap 
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Related Commands 
BlackPixel, WhitePixel, XAllocColorCells, XAllocColorPlanes, XAlloc- 
NamedColor, XFreeColors, XLookupColor, XParseColor, XQueryColor, 
XQueryColors, XStoreColor, XStoreColors, XStoreNamedColor. 
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Name 
XAllocColorCells — allocate read/write (nonshared) colorcells. 


Synopsis 
Status XAllocColorCells (display, cmap, contig, plane_masks, 
nplanes, pixels, ncolors) 
Display *display; 
Colormap cmap; 
Bool contig; 
unsigned long plane_masks[nplanes] ; /* RETURN */ 
unsigned int nplanes; 
unsigned long pixels[ncolors] ; /* RETURN pixel values */ 
unsigned int ncolors; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
cmap Specifies the ID of the colormap in which the colorcell is to be allocated. 
contig Specifies a boolean value. Pass True if the planes must be contiguous or 


False if the planes need not be contiguous. 


Pplane_mask _ Returns an array of plane masks. 


nplanes Specifies the number of plane masks returned in the plane masks array. Must 
be nonnegative. 
pixels Returns an array of pixel values. 
ncolors Specifies the number of pixel values returned in the pixels array. Must be 
positive. 
Description 


XAllocColorCells allocates read/write colorcells in a read/write colormap. If ncolors 
and nplanes are requested, then ncolors pixels and nplanes plane masks are returned. 
No mask will have any bits in common with any other mask, or with any of the pixels. By 
ORing together each of the pixels with any combination of the plane masks, 
ncolors*2 (planes) distinct pixels can be produced. For GrayScale or PseudoColor, 
each mask will have exactly one bit, and for DirectColor each will have exactly three bits. 
If contig is True, then if all plane masks are ORed together, a single contiguous set of bits 
will be formed for GrayScale or PseudoColor and three contiguous sets of bits (one 
within each pixel subfield) for DirectColor. The RGB values of the allocated entries are 
undefined until set with XStoreColor, XStoreColors, or XStoreNamedColor. 


Status is zero on failure, and nonzero on success. 


For more information, see Volume One, Chapter 7, Color. 
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Errors 
BadColormap 


BadValue nplanes is negative. 
ncolors is not positive. 


Related Commands 
BlackPixel, WhitePixel, XAllocColor, XAllocColorPlanes, XAllocNamed- 
Color, XFreeColors, XLookupColor, XParseColor, XQueryColor, XQuery- 
Colors, XStoreColor, XStoreColors, XStoreNamedColor. 
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Name 
XAllocColorPlanes — allocate read/write (nonshareable) color planes. 


Synopsis 
Status XAllocColorPlanes (display, cmap, contig, pixels, ncolors, 
nreds, ngreens, nblues, rmask, gmask, bmask) 
Display *display; 
Colormap cmap; 
Bool contig; 
unsigned long pixels[ncolors]; /* RETURN */ 
Ine “Colors; 
int nreds, ngreens, nblues; 
unsigned long *rmask, *gmask, *bmask; /* RETURN */ 


Arguments . 
display Specifies a connection to an X server; returned from XOpenDisplay. 
cmap Specifies the ID of the colormap to be used. 
contig Specifies a boolean value. Pass True if the planes must be contiguous or 
False if the planes do not need to be contiguous. 
pixels Returns an array of pixel values. 
ncolors Specifies the number of pixel values returned in the pixels array. Must be posi- 
tive. 
nreds Specify the number of red, green, and blue planes (shades). Must be nonnega- 
ngreens tive. 
nblues 
rmask Return bit masks for the red, green, and blue planes. 
gmask 
bmask 
Description 


If ncolors, nreds, ngreens, and nblues are requested, then ncolors pixels are 
returned, and the masks have nreds, ngreens, and nblues bits set to 1 respectively. 
Unique pixel values are generated by by ORing together subsets of masks with each item in the 
pixels list (pixels does not by itself contain pixel values). In doing this, note that 
ncolors*( 2 (redstngreens+nblues) ) distinct pixel values are allocated. 


If contig is True, then each mask will have a contiguous set of bits. No mask will have any 
bits in common with any other mask, or with any of the pixels. For DirectColor, each 
mask will lie within the corresponding pixel subfield. 


Note, however, that there are actually only ncolors*(2"re¢s ) independent red entries, 
ncolors’*(2 "9reens ) independent green entries, and ncolors*(2 ">1ues ) independent blue 
entries in the colormap. This is true even for PseudoColor. This does not cause problems, 
though, because when the colormap entry for a pixel value is changed using XStoreColors 
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or XStoreNamedColor, the pixel is decomposed according to rmask, gmask, and bmask 
and the corresponding pixel subfield entries are updated. 


Status is zero on failure, and nonzero on success. 

For more information, see Volume One, Chapter 7, Color. 
Errors 

BadColormap 

BadValue ncolors is not positive. ” 


At least one of nreds, ngreens, nblues is negative. 


Related Commands 
BlackPixel, WhitePixel, XAllocColor, XAllocColorCells, XAllocNamed- 
Color, XFreeColors, XLookupColor, XParseColor, XQueryColor, XQuery- 
Colors, XStoreColor, XStoreColors, XStoreNamedColor. 
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Name 
XAllocIconSize — allocate an XIconSize structure. 


Synopsis 
XIconSize *XAllocIconSize ( ) 


Availability 
Release 4 and later. 


Description 
XAllocIconSize allocates and returns a pointer to an XIconSize structure, for use in cal- 
ling XGet IconSizes or XSetIconSizes. Note that all fields in the XIconSize struc- 
ture are initially set to zero. If insufficient memory is available, XAllocIconSize returns 
NULL. To free the memory allocated to this structure, use XF ree. 


The purpose of this function is to avoid compiled-in structure sizes, so that object files will be 
binary compatible with later releases that may have new members added to structures. 


For more information, see Volume One, Chapter 10, Interclient Communication. 


Structures 
typedef struct { 
int min_width, min_height; 
int max_width, max_height; 
int width_inc, height_inc; 
} XIconSize; 


Related Commands 
XGetIconSizes, XSetIconSizes. 
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Name ; 
XAllocNamedColor — allocate a read-only colorcell from color name. 


Synopsis 
Status XAllocNamedColor (display, cmap, colorname, 
colorcell def, rgb_db def) 
Display *display; 
Colormap cmap; 
char *colorname; ES 
Keelor *colorcell def; /* RETURN */ 
XColor *rgb_db def; /* RETURN .*/ 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 


cmap Specifies the ID of the colormap in which the colorcell will be allocated. 


colorname Specifies the color name string (for example, “red”) you want. Upper or 
lower case does not matter. The string should be in ISO LATIN-1 encoding, 
which means that the first 128 character codes are ASCII, and the second 128 
character codes are for special characters needed in western languages other 
than English. 


coiorcell der 
Returns the pixel value and RGB values actually used in the colormap. This 
is the closest color supported by the hardware. 


rgb_db def Returns the exact RGB values from the database corresponding to the 
colorname supplied. 


Description 

XAllocNamedColor determines the RGB values for the specified colorname from the 
color database, and then allocates a read-only colorcell with the closest color available, as 
described under XAllocColor. Both the ‘exact’ database definition of the color, and the 
color actually allocated are returned. If the colormap is not full, the RGB values allocated are 
the closest supported by the hardware. If the colormap is full, and is a StaticColor, 
DirectColor, or StaticGray visual class, XAllocNamedColor returns the closest 
read-only colorcell already allocated, and does not actually create or set any new colorcell. If 
the colormap is full and is a PseudoColor, TrueColor, or GrayScale visual class, 
XAllocNamedColor fails and returns zero. 


XAllocNamedColor returns a Status of zero if colorname was not found in the data- 
base or if the color could not be allocated. The function returns nonzero when it succeeds. 


For more information, see Volume One, Chapter 7, Color. 
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Errors 
BadColormap 
BadName 


Structures 
typedef struct { 
unsigned long pixel; 
unsigned short red, green, blue; 
char flags; /* DoRed, DoGreen, DoBlue */ 
char pad; 
ax Colon: 


Related Commands 
BlackPixel, WhitePixel, XAllocColor, XAllocColorCells, XAllocColor- 
Planes, XFreeColors, XLookupColor, XParseColor, XQueryColor, XQuery- 
Colors, XStoreColor, XStoreColors, XStoreNamedColor. 
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Name ’ 
XAllocSizeHints — allocate an XSizeHints Structure. 


Synopsis 
XSizeHints *XAllocSizeHints() 


Availability 
Release 4 and later. 


Description 
XAllocSizeHints allocates and returns a pointer to an XSizeHints structure, for use in 


calling XSetWMP roperties, XSetWMNormalHints, or XGetWMNormalHints. Note 
that all fields in the XSizeHints structure are initially set to zero. If insufficient memory is 
available, XAllocSizeHints returns NULL. To free the memory allocated to this structure, 
use XF ree. : 

The purpose of this function is to avoid compiled-in structure sizes, so that object files will be 
binary compatible with later releases that may have new members added to structures. 


For more information, see Volume One, Chapter 10, Interclient Communication. 


Structures 
typedef struct { 
long flags; /* marks which fields in this structure are defined */ 
abate exee a Vie /* Obsolete */ 


int width, height; /* Obsolete */ 
int min_width, min_height; 
int max width, max height; 
IM width eine, nemght ine, 


StEruet “f{ 
int x; /* numerator */ 
imine /* denominator */ 


} min_aspect, max aspect; 
int base width, base height; 
int win_gravity; 

} XSizeHints; 


Related Commands 
XGetWMNormalHints, XSetWMNormalHints, XSetWMProperties. 
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Name 
XAllocStandardColormap — allocate an XStandardColormap structure. 


Synopsis 
XStandardColormap *XAllocStandardColormap ( ) 


Availability 
Release 4 and later. 


Description 
XAllocStandardColormap allocates and returns a pointer to an XSt andardColormap 
structure for use in calling XGet RGBColormaps or XSetRGBColormaps. Note that all 
fields in the XSt andardColormap structure are initially set to zero. If insufficient memory 
is available, XAllocStandardColormap returns NULL. To free the memory allocated to 
this structure, use XF ree. 


The purpose of this function is to avoid compiled-in structure sizes, so that object files will be 
binary compatible with later releases that may have new members added to structures. 


For more information, see Volume One, Chapter 7, Color. 


Structures 
/* value for killid field */ 


#define ReleaseByFreeingColormap (= CXED)> Ih) 


typedef struct { 
Colormap colormap; 
unsigned long red _ max; 
unsigned long red mult; 
unsigned long green_max; 
unsigned long green mult; 
unsigned long blue max; 
unsigned long blue mult; 
unsigned long base pixel; 
VisualID visualid; 
AED we keeled 

} XStandardColormap; 


Related Commands 
XGetRGBColormaps, XSetRGBColormaps. 
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Name 


‘ 


XAllocWMHints — allocate an XWMHints Structure. 


Synopsis 


XWMHints *XAllocWMHints() 


Availability 
Release 4 and later. 


Description 


The XAllocWMHints function allocates and returns a pointer to an XWMHints structure, for 
use in calling XSetWMProperties, XSetWMHints, or XGetWMHints. Note that all fields 
in the XWMHints structure are initially set to zero. If insufficient memory is available, 
XAllocWMHints returns NULL. To free the memory allocated to this structure, use XF ree. 


The purpose of this function is to avoid compiled-in structure sizes, so that object files will be 
binary compatible with later releases that may have new members added to structures. 


For more information, see Volume One, Chapter 10, Interclient Communication. 


Structures 
typedef struct { 
long flags; 
Bool input; 


Ine, init vel estate, 
Pixmap icon pixmap; 
Window icon window; 
MG NCOn ses. CON: Y7 
Pixmap icon mask; 
XID window_group; 


/* 
/* 


/* 
/* 
/* 
/* 
/* 
/* 


marks which fields in this structure are defined */ 

does this application rely on the window manager 
to get keyboard input? */ 

see below */ 

pixmap to be used as icon */ 

window to be used as icon */ 

initial position of icon */ 

pixmap to be used as mask for icon pixmap */ 

id of related window group */ 


/* this structure may be extended in the future */ 


} XWMHints; 


Related Commands 


XGetWMHints, XSetWMHints, XSetWMProperties. 
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Name 
XAllowEvents — control the behavior of keyboard and pointer events when these resources are 
grabbed. 
Synopsis 


XAllowEvents (display, event_mode, time) 
Display *display; 
int event_mode; 
Time time; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 


event_mode_ Specifies the event mode. Pass one of these constants: AsyncPointer, 
SyncPointer, AsyncKeyboard, SyncKeyboard, ReplayPointer, 
ReplayKeyboard, AsyncBoth, or SyncBoth. 


time Specifies the time when the grab should take place. Pass either a timestamp, 
expressed in milliseconds, or the constant Current Time. 


Description 
XAllowEvents releases the events queued in the server since the last XAllowEvents call 
for the same device and by the same client. Events are queued in the server (not released to 
Xlib to propagate into Xlib’s queues) only when the client has caused a device to “freeze” (by 
grabbing the device with mode GrabModeSync). The request has no effect if time is earlier 
than the last-grab time or later than the current server time. 


The event_mode argument controls what device events are released for and just how and 
when they are released. The event_mode is interpreted as follows: 


AsyncPointer If XAllowEvents is called with AsyncPointer while the 
pointer is frozen by the client, pointer event processing resumes nor- 
mally, even if the pointer is frozen twice by the client on behalf of 
two separate grabs. AsyncPointer has no effect if the pointer is 
not frozen by the client, but the pointer need not be grabbed by the 
client. 


AsyncKeyboard If XAllowEvents is called with AsyncKeyboard while the key- 
board is frozen by the client, keyboard event processing resumes 
normally, even if the keyboard is frozen twice by the client on behalf 
of two separate grabs. AsyncKeyboard has no effect if the key- 
board is not frozen by the client, but the keyboard need not be 
grabbed by the client. 


SyncPointer If XAllowEvents is called with SyncPointer while the pointer 
is frozen by the client, normal pointer event processing continues 
until the next ButtonPress or ButtonRelease event is 
reported to the client. At this time, the pointer again appears to 
freeze. However, if the reported event causes the pointer grab to be 


t 
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SyncKeyboard 


ReplayPointer 


ReplayKeyboard 


SyncBoth 


AsyncBoth 
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released, then the pointer does not freeze, which is the case when an 
automatic grab is reledsed by a ButtonRelease or when XGrab- 
Button or XGrabKey has been called and the specified key or but- 
ton is released. SyncPointer has no effect if the pointer is not 
frozen or not grabbed by the client. 


If XAllowEvents is called with SyncKeyboard while the key- 
board is frozen by the client, normal keyboard event processing con- 
tinues until the next KeyPress or KeyRelease event is reported 
to the client. At this time, the keyboard again appears to freeze. 
However, if the reported event causes the keyboard grab to be 
released, then the keyboard does not freeze, which is the case when 
an automatic grab is released by a ButtonRelease or when 
XGrabButton or XGrabKey has been called and the specified key 
or button is released. SyncKeyboard has no effect if the keyboard 
is not frozen or not grabbed by the client. 


This symbol has an effect only if the pointer is grabbed by the client 
and thereby frozen as the result of an event. In other words, 
XGrabButton must have been called and the selected button/key 
combination pressed, or an automatic grab (initiated by a Button- 
Press) must be in effect, or a previous XAllowEvents must have 
been called with mode SyncPointer. If the pointer mode of 
the XGrabPointer was GrabModeSync, then the grab is 
released and the releasing event is processed as if it had occurred 
after the release, ignoring any passive grabs at or above in the hierar- 
chy (towards the root) on the grab-window of the grab just released. 


This symbol has an effect only if the keyboard is grabbed by the cli- 
ent and if the keyboard is frozen as the result of an event. In other 
words, XGrabKey must have been called and the selected key com- 
bination pressed, or a previous XAllowEvents must have been 
called with mode SyncKeyboard. If the pointer mode or 
keyboard _mode of the XGrabKey was GrabModeSync, then 
the grab is released and the releasing event is processed as if it had 
occurred after the release, ignoring any passive grabs at or above in 
the hierarchy (towards the root). 


SyncBoth has the effect described for both SyncKeyboard and 
SyncPointer. SyncBoth has no effect unless both pointer and 
keyboard are frozen by the client. If the pointer or keyboard is fro- 
zen twice by the client on behalf of two separate grabs, SyncBoth 
“thaws” for both (but a subsequent freeze for SyncBoth will only 
freeze each device once). 


AsyncBoth has the effect described for both AsyncKeyboard 
and AsyncPointer. AsyncBoth has no effect unless both 
pointer and keyboard are frozen by the client. If the pointer and the 
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keyboard were frozen by the client, or if both are frozen twice by 
two separate grabs, event processing (for both devices) continues 
normally. If a device is frozen twice by the client on behalf of the 
two separate grabs, AsyncBoth releases events for both. 


AsyncPointer, SyncPointer, and ReplayPointer have no effect on the processing of 
keyboard events. AsyncKeyboard, SyncKeyboard, and ReplayKeyboard have no 
effect on the processing of pointer events. 


It is possible for both a pointer grab and a keyboard grab (by the same or different clients) to be 
active simultaneously. If a device is frozen on behalf of either grab, no event processing is per- 
formed for the device. It is also possible for a single device to be frozen because of both grabs. 
In this case, the freeze must be released on behalf of both grabs before events will be released. 


For more information on event handling, see Volume One, Chapter 9, The Keyboard and 
Pointer. 


Errors 


BadValue Invalid mode constant. 


Related Commands 
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QLength, XCheckIfEvent, XCheckMaskEvent, XCheckTypedEvent, XCheck- 
TypedWindowEvent, XCheckWindowEvent, XEvent sQueued, XGet InputFocus, 
XGetMotionEvents, XIfEvent, XMaskEvent, XNextEvent, XPeekEvent, XPeek- 
IfEvent, XPending, XPutBackEvent, XSelect Input, XSendEvent, XSetInput- 
Focus, XSynchronize, XWindowEvent. 
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Name | 
XAutoRepeatOff — turn off the keyboard auto-repeat keys. 
Synopsis 
XAutoRepeatOff (display) 
Display *display; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 


Description 


XAutoRepeatoOff turns off auto-repeat for the keyboard. It sets the keyboard so that holding 
any non-modal key down will not result in multiple events. 


Related Commands 


XAutoRepeatoOn, XBell, XChangeKeyboardControl, XGetDefault, XGet- 
KeyboardControl, XGetPointerControl. 
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Name 
XAutoRepeatOn — turn on the keyboard auto-repeat keys. 
Synopsis 
XAutoRepeatOn (display) 
Display *display; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 


Description 
XAutoRepeatoOn sets the keyboard to auto-repeat; that is, holding any non-modal key down 
will result in multiple KeyPress and KeyRelease event pairs with the same keycode 
member. Keys such as Shift Lock will still not repeat. 


Related Commands 
XAutoRepeatOff, XBell, XChangeKeyboardControl, XGetDefault, XGet- 
KeyboardControl, XGetPointerControl. 
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Name 
XBell — ring the bell (Control G). 
Synopsis 
XBell (display, percent) 
Display *display; 
int percent; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 


percent Specifies the volume for the bell, relative to the base volume set with 
XChangeKeyboardControl. Possible values are —100 (off), through 0 
(base volume), to 100 (loudest) inclusive. 


Description 
Rings the bell on the keyboard at a volume relative to the base volume, if possible. percent 
can range from —100 to 100 inclusive (else a BadValue error). The volume at which the bell 
is rung when percent is nonnegative is: 


volume = base - [(base * percent) / 100] + percent 
and when percent is negative: 
volume = base + [(base * percent) / 100] 


To change the base volume of the bell, set the bell percent variable of XChange- 


Keyboardcontrol. 
Errors 
BadValue percent <-100 or percent >100. 


Related Commands 
XAutoRepeatOff, XAutoRepeatOn, XChangeKeyboardControl, XGetDefault, 
XGetKeyboardControl, XGetPointerControl. 
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Name 
XChangeActivePointerGrab — change the parameters of an active pointer grab. 


Synopsis 
XChangeActivePointerGrab (display, event_mask, cursor, time) 
Display *display; 
unsigned int event_mask; 
Culrso»m (cursor; 
Time time; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 


event_mask Specifies which pointer events are reported to the client. This mask is the bit- 
wise OR of one or more of these pointer event masks: ButtonPressMask, 
ButtonReleaseMask, EnterWindowMask, LeaveWindowMask, 
PointerMotionMask, PointerMotionHintMask, Buttonl- 
MotionMask, Button2MotionMask, Button3MotionMask, But- 
ton4MotionMask, Button5MotionMask, ButtonMotionMask, 


KeymapStateMask. 

cursor Specifies the cursor that is displayed. A value of None will keep the current 
cursor. 

time Specifies the time when the grab should take place. Pass either a timestamp, 


expressed in milliseconds, or the constant Current Time. 


Description 
XChangeActivePointerGrab changes the characteristics of an active pointer grab, if the 
specified time is no earlier than the last pointer grab time and no later than the current X server 
time. XChangeActivePointerGrab has no effect on the passive parameters of XGrab- 
Button, or the automatic grab that occurs between ButtonPress and ButtonRelease. 


event_mask is always augmented to include ButtonPress and ButtonRelease. 
For more information on pointer grabbing, see Volume One, Chapter 9, The Keyboard and 
Pointer. 
Errors 
BadCursor 
BadValue The event_mask argument is invalid. 
Related Commands 
XChangePointerControl, XGetPointerControl, XGetPointerMapping, 


XGrabPointer, XQueryPointer, XSetPointerMapping, XUngrabPointer, 
XWarpPointer. 
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Name 
XChangeGC — change the components of a given graphics context. 


Synopsis 
XChangeGC (display, gc, valuemask, values) 
Display *display; 
GCigc; 
unsigned long valuemask; 
XGCValues *values; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
gc Specifies the graphics context. | 


valuemask Specifies the components in the graphics context that you want to change. 
This argument is the bitwise OR of one or more of the GC component masks. 


values Specifies a pointer to the XGCValues structure. 


Description 
XChangeGC changes any or all of the components of aGC. The valuemask specifies which 
components are to be changed; it is made by combining any number of the mask symbols listed 
in the Structures section using bitwise OR (|). The values structure contains the values to be 
set. These two arguments operate just like they do in XCreateGC. Changing the 
clip mask overrides any previous XSetClipRectangles request for this GC. Changing 
the dash_offset or dash_list overrides any previous XSetDashes request on this GC. 


Since consecutive changes to the same GC are buffered, there is no performance advantage to 
using this routine over the routines that set individual members of the GC. 


Even if an error occurs, a subset of the components may have already been altered. 


For more information, see Volume One, Chapter 5, The Graphics Context, and Chapter 6, 
Drawing Graphics and Text. 


Structures 
typedef struct { 
int function; /* logical operation */ 
unsigned long plane mask; /* plane mask */ 
unsigned long foreground; /* foreground pixel */ 
unsigned long background; /* background pixel */ 


int line width; /* line width */ 

int line style; /* LineSolid, LineOnOffDash, LineDoubleDash */ 

int cap_style; /* CapNotLast, CapButt, CapRound, CapProjecting */ 
int joinustyle; /* JoinMiter, JoinRound, JoinBevel */ 

int fod d sty le, /* FillSolid, FillTiled, FillStippled */ 

int Sit Werle: /* EvenOddRule, WindingRule */ 

int arc_mode; /*AecChord,, ArcPiesiice: */ 

Pixmap tile; /* tile pixmap for tiling operations */ 

Pixmap stipple; /* stipple 1 plane pixmap for stipping */ 

inte ts2xk. Onl Ln, /* offset for tile or stipple operations */ 
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They Cspy Or Loam, 


Font font; /* default text font for text operations */ 

int subwindow_mode; /* ClipByChildren, IncludeInferiors */ 

Bool graphics exposures; /* generate events on XCopy, Area, XCopyPlane*/ 
Hiritems Culex Onell [x omigin tor clipping, =/ 

int ielipry yor oin; 

Pixmap clip mask; /* bitmap clipping; other calls for rects */ 
inikedashoOLeset, /* patterned/dashed line information */ 


char dashes; 
} XGCValues; 


#define GCFunction (1L<<0) 
#define GCPlaneMask (LL<<1) 
#define GCForeground (1L<<2) 
#define GCBackground (1L<<3) 
#define GCLineWidth (1L<<4) 
#define GCLineStyle (<5) 
#define GCCapStyle (LL<<6) 
#define GCJoinStyle (1L<<7) 
#define GCFillStyle (1L<<8) 
#define GCFillRule (1L<<9) 
#define GCTile (1L<<10) 
#define GCStipple (1L<<11) 
#define GCTileStipXOrigin (e<< 1/2) 
#define GCTileStipYOrigin (1iL<S<13) 
#define GCFont (1L<<14) 
#define GCSubwindowMode (1L<<15) 
#define GCGraphicsExposures (1L<<16) 
#define GCClipxXOrigin (IL <I1 7.) 
#define GCClipYOrigin (1L<<18) 
#define GCClipMask (1L<<19) 
#define GCDashOffset (1L<<20) 
#define GCDashList (1L<<21) 
#define GCArcMode (1L<<22) 
Errors 
BadAlloc 
BadFont 
BadGC 
BadMatch 
BadPixmap 
BadValue 


Related Commands 
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DefaultGC, XCopyGC, XCreateGC, XFreeGC, XGContextFromGC, XGetGCValues, 
XSetArcMode, XSetBackground, XSetClipMask, XSetClipOrigin, XSetClip- 
Rectangles, XSetDashes, XSetFillRule, XSetFillStyle, XSetForeground, 
XSetFunction, XSetGraphicsExposures, XSetLineAttributes, XSetPlane- 
Mask, XSetRegion, XSetState, XSetStipple, XSet SubwindowMode, XSet- 
TSOxvie in, 
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Name 
XChangeKeyboardControl — change the keyboard preferences such as key click. 


Synopsis 
XChangeKeyboardControl (display, value_mask, values) 
Display *display; 
unsigned long value _mask; 
XKeyboardControl *values; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 


value_mask Specifies a mask composed of ORed symbols from the table shown in the 
Structures section below, specifying which fields to set. 


values Specifies the settings for the keyboard preferences. 


Description 
XChangeKeyboardCont rol sets user preferences such as key click, bell volume and dura- 
tion, light state, and keyboard auto-repeat. Changing some or all these settings may not be pos- 
sible on all servers. 


The value_mask argument specifies which values are to be changed; it is made by combin- 
ing any number of the mask symbols listed in the Structures section using bitwise OR (|). 


The values structure contains the values to be set, as follows: 


key click percent sets the volume for key clicks between 0 (off) and 100 (loud) inclu- 
sive. Setting to —1 restores the default. 


bell percent sets the base volume for the bell between 0 (off) and 100 (loud) inclusive. 
Setting to —1 restores the default. 


bell pitch sets the pitch (specified in Hz) of the bell. Setting to —-1 restores the default. 


bell duration sets the duration (specified in milliseconds) of the bell. Setting to -1 
restores the default. 


led_mode is either LedModeOn or LedModeOff. led is a number between 1 and 32 inclu- 
sive that specifies which light’s state is to be changed. If both led_mode and led are speci- 
fied, then the state of the LED specified in led is changed to the state specified in led_mode. 
If only led_mode is specified, then all the LEDs assume the value specified by led_mode. 


auto _repeat_mode is either AutoRepeatModeOn, AutoRepeatModeOff, or Auto- 
RepeatModeDefault. key is a keycode between 7 and 255 inclusive. If both 
auto _repeat_mode and key are specified, then the auto-repeat mode of the key specified 
by key is set as specified by auto_repeat_mode. If only auto_repeat_mode is speci- 
fied, then the global auto repeat mode for the entire keyboard is changed, without affecting the 
settings for each key. If the auto_repeat_mode is AutoRepeatModeDefault for 

- either case, the key or the entire keyboard is returned to its default setting for the server, which 
is normally to have all non-modal keys repeat. 
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When a key is being used as a modifier key, it does not repeat regardless of the individual or 
global auto repeat mode. 


The order in which the changes are performed is server-dependent, and some may be completed 
when another causes an error. 


For more information on user preferences, see Volume One, Chapter 9, The Keyboard and 


Pointer. 


Structures 


/* masks for ChangeKeyboardControl */ 


#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 


KBKeyClickPercent (1L<<0) 
KBBel1lPercent (1L<<1) 
KBBellPitch (1L<<2) 
KBBellDuration (1L<<3) 
KBLed (1L<<4) © 
KBLedMode (1L<<5) 
KBKey (1L<<6) 
KBAutoRepeatMode (1L<<7) 


/* structure for ChangeKeyboardControl */ 


typedef struct { 
int key click_percent; 
int bell percent; 
int, bell spitceh; 
imc bell duration; 
int led; 
int led_mode; /* LedModeOn or LedModeOff */ 
int key; 
int auto_repeat_mode; /* AutoRepeatModeOff, AutoRepeatModeOn, 
AutoRepeatModeDefault */ 
} XKeyboardControl; 
Errors 
BadMatch values.key specified but values. auto. repeat .mode not specified. 
values.led specified but values.1led_mode not specified. 
BadValue values.key click_percent < -1. 


values. bell percent < -2. 
values.bell pitch < -1. 
values.bell duration < -1. 


Related Commands 
XAutoRepeatOff, XAutoRepeatoOn, XBell, XGetDefault, XGetKeyboard- 
Control, XGetPointerControl. 
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Name 5 
XChangeKeyboardMapping — change the keyboard mapping. 


Synopsis 
XChangeKeyboardMapping(display, first_code, keysyms_per_code, 

keysyms, num_codes) 

Display *display; 

int first_keycode; 

int keysyms_ per keycode; 

KeySym *keysyms; - 

int num_keycodes; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 


first_keycode 
Specifies the first keycode that is to be changed. 


_keysyms_per_keycode 
Specifies the number of keysyms that the caller is supplying for each keycode. 


keysyms Specifies a pointer to the list of keysyms. 


num_keycodes 
Specifies the number of keycodes that are to be changed. 


Description 

Starting with first keycode, XChangeKeyboardMapping defines the keysyms for the 
specified number of keycodes. The symbols for keycodes outside this range remain unchanged. 
The number of elements in the keysyms list must be a multiple of keysyms_per_keycode 
(else a BadLength error). The specified first_keycode must be greater than or equal to 
min_keycode supplied at connection setup and stored in the display structure (else a Bad- 
Value error). In addition, the following expression must be less than or equal to max_key- 
code field of the Display structure (else a BadValue error): 


max keycode >= first_keycode + (num_keycodes / keysyms per keycode) - 1 


The keysym number N (counting from 0) for keycode K has an index in the keysyms array 
(counting from 0) of the following (in keysyms): 


index = (K - first _keycode) * keysyms per keycode + N 


The specified keysyms_per_keycode can be chosen arbitrarily by the client to be large 
enough to hold all desired symbols. A special keysym value of NoSymbol1 should be used to 
fill in unused elements for individual keycodes. It is legal for NoSymbo1 to appear in nontrail- 
ing positions of the effective list for a keycode. 


XChangeKeyboardMapping generates a Mappi ngNotify event, sent to this and all other 
clients, since the keycode to keysym mapping is global to all clients. 
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Errors 
BadAlloc 


BadValue first. keycode less than display->min_keycode. 
display->max_keycode exceeded (see above). 


Related Commands 
XDeleteModifiermapEntry, XFreeModifiermap, XGetKeyboardMapping, 
XGetModifierMapping, XInsertModifiermapEntry, XKeycodeToKeysym, 
XKeysymToKeycode, XKeysymToString, XLookupKeysym, XLookupString, 
XNewModifierMap, XQueryKeymap, XRebindKeySym, XRefreshKeyboard- 
Mapping, XSetModifierMapping, XStringToKeysym. 
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Name 
XChangePointerControl — change the pointer preferences. 


Synopsis 
XChangePointerControl (display, do_accel, do_threshold, 
accel numerator, accel_denominator, threshold) 
Display *display; 
Bool do_accel, do_threshold; 
int accel numerator, accel_denominator; 
int threshold; a 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
do: accel Specifies a boolean value that controls whether the values for the 


accel numerator or accel denominator are set. You can pass one 
of these constants: True or False. 


do_threshold 
Specifies a boolean value that controls whether the value for the threshold is 
set. You can pass one of these constants: True or False. 


accel numerator 
Specifies the numerator for the acceleration multiplier. 


accel denominator 
Specifies the denominator for the acceleration multiplier. 


threshold _ Specifies the acceleration threshold. 


Description 
XChangePointerControl defines how the pointing device functions. The acceleration is 
a fraction (accel_numerator/accel_denominator) which specifies how many times 
faster than normal the sprite on the screen moves for a given pointer movement. Acceleration 
takes effect only when a particular pointer motion is greater than threshold pixels at once, 
and only applies to the motion beyond threshold pixels. The values for do_accel and 
do_threshold must be nonzero for the pointer values to be set; otherwise, the parameters 
will be unchanged. Setting any of the last three arguments to —1 restores the default for that 
argument. 


The fraction may be rounded arbitrarily by the server. 


Errors 
BadValue accel _denominatoris0. 
Negative value for do_accel or.do_threshold. 
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Related Commands 
XChangeActivePointerGrab, XGetPointerControl, XGetPointerMapping, 
XGrabPointer, XQueryPointer, XSetPointerMapping, XUngrabPointer, 
XWarpPointer. 
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Name 
XChangeProperty — change a property associated with a window. 


Synopsis 
XChangeProperty (display, w, property, type, format, mode, 

data, nelements) 

Display *display; 

Window w; 

Atom property, type; 

int format; 

int mode; 

unsigned char *data; 

int neleméents; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
w : Specifies the ID of the window whose property you want to change. 


property Specifies the property atom. 


type Specifies the type of the property. X does not interpret the type, but simply 
passes it back to an application that later calls xGet Property. 
format Specifies whether the data should be viewed as a list of 8-bit, 16-bit, or 32-bit 


quantities. This information allows the X server to correctly perform byte- 
swap operations as necessary. If the format is 16-bit or 32-bit, you must 
explicitly cast your data pointer to a (char ~*) in the call to XChange- 
Property. Possible values are 8,16, and 32. 


mode Specifies the mode of the operation. Possible values are PropMode- 
Replace, PropModeP repend, PropModeAppend, or no value. 


data Specifies the property data. 
nelements Specifies the number of elements in the property. 


Description 


XChangeProperty changes a property and generates PropertyNotify events if they 
have been selected. 


XChangeProperty does the following according to the mode argument: 


* PropModeReplace 
Discards the previous property value and stores the new data. 


e PropModePrepend 
Inserts the data before the beginning of the existing data. If the property is undefined, it 
is treated as defined with the correct type and format with zero-length data. type and 
format arguments must match the existing property value; otherwise a BadMatch 
error Occurs. 
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e PropModeAppend 
Appends the data onto the end of the existing data. If the property is undefined, it is 
treated as defined with the correct type and format with zero-length data. type and 
format arguments must match the existing property value; otherwise a BadMatch 
error occurs. 


The property may remain defined even after the client which defined it exits. The property 
becomes undefined only if the application calls xDeleteProperty, destroys the specified 
window, or closes the last connection to the X server. 


The maximum size of a property is server-dependent and can vary dynamically if the server has 
insufficient memory. 


For more information, see Volume One, Chapter 10, Interclient Communication. 


Errors 
BadAlloc 
BadAtom 
BadMatch 
BadValue 
BadWindow 


Related Commands 
XDeleteProperty, XGetAtomName, XGetFontProperty, XGetWindowProperty, 
XInternAtom, XListProperties, XRotateWindowProperties, XSetStandard- 
Properties. 
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Name 
XChangeSaveSet — add or remove a subwindow from the client’s save-set. 


Synopsis 
XChangeSaveSet (display, w, change_mode) 
Display *display; 
Window w; 
int change_mode; 


Arguments Es 
display Specifies a connection to an X server; returned from XOpenDisplay. 
w Specifies the ID of the window whose children you want to add or remove 


from the client’s save-set; it must have been created by some other client. 


change_mode Specifies the mode. Pass one of these constants: SetModeInsert (adds 
the window to this client’s save-set) or SetModeDelete (deletes the win- 
dow from this client’s save-set). 

Description 

XChangeSaveSet adds or deletes windows from a client’s save-set. This client is usually 

the window manager. 

The save-set of the window manager is a list of other client’s top-level windows which have 

been reparented. If the window manager dies unexpectedly, these top-level application win- 

dows are children of a window manager window and therefore would normally be destroyed. 

The save-set prevents this by automatically reparenting the windows listed in the save-set to 

their closest existing ancestor, and then remapping them. 


Windows are removed automatically from the save-set by the server when they are destroyed. 
For more information on save-sets, see Volume One, Chapter 13, Other Programming Tech- 
niques. 

Errors 
BadMatch w not created by some other client. 
BadValue 
BadWindow 


Related Commands 
XAddToSaveSet, XRemoveFromSaveSet. 
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Name 


XChangeWindowAttributes — set window attributes. 


Synopsis 


XChangeWindowAttributes (display, w, valuemask, attributes) 
Display *display; 
Window w; 
unsigned long valuemask; 
XSetWindowAttributes *attributes; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
Ww Specifies the window ID. 


valuemask — Specifies which window attributes are defined in the attributes argu- 
ment. The mask is made by combining the appropriate mask symbols listed 
in the Structures section using bitwise OR (|). If valuemask is zero, the 
rest is ignored, and attributes is not referenced. The values and restric- 
tions are the same as for XCreateWindow. 


attributes Window attributes to be changed. The valuemask indicates which mem- 
bers in this structure are referenced. 


Description 
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XChangeWindowAttributes changes any or all of the window attributes that can be 
changed. For descriptions of the window attributes, see Volume One, Chapter 4, Window Attri- 
butes. 


Changing the background does not cause the window contents to be changed immediately—not 
until the next Expose event or XClearWindow call. Drawing into the pixmap that was set 
as the background pixmap attribute has an undefined effect on the window background. The 
server may or may not make a copy of the pixmap. Setting the border causes the border to be 
repainted immediately. Changing the background of a root window to None or Parent- 
Relative restores the default background pixmap. Changing the border of a root window to 
CopyFromParent restores the default border pixmap. 


Changing the win_gravity does not affect the current position of the window. Changing 
the backing_store of an obscured window to WhenMapped or Always may have no 
immediate effect. Also changing the backing planes, backing _pixel, or 
save_under of a mapped window may have no immediate effect. 


Multiple clients can select input on the same window; the event_mask attributes passed are 
disjoint. When an event is generated it will be reported to all interested clients. Therefore, the 
setting of the event_mask attribute by one client will not affect the event_mask of others 
on the same window. However, at most, one client at a time can select each of 
Subst ructureRedirectMask, ResizeRedirectMask, and ButtonPressMask on 
any one window. Ifa client attempts to select on Subt ructureRedirectMask, Resize- 
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XChangeWindowaAttributes 


RedirectMask, or ButtonPressMask and some other client has already selected it on the 
same window, the X server generates a BadAccess error. 


There is only one do_not_propagate_mask for a window, not one per client. 


Changing the colormap attribute of a window generates a ColormapNotify event. Chang- 
ing the colormap attribute of a visible window may have no immediate effect on the screen 
(because the colormap may not be installed until the window manager calls XInstall- 
Colormap). 


Changing the cursor of a root window to None restores the default cursor. 


For more information, see Volume One, Chapter 2, X Concepts, and Chapter 4, Window Attri- 


butes. 


Structures 
/ * 


'* Data structure for setting window attributes. 


7, 


typedef struct { 


Pixmap background _pixmap; 


/* 


unsigned long background pixel; /* 
Pixmap border pixmap; 


unsigned long border pixel; 


int bit_gravity; 
int win_gravity; 
int backing store; 


unsigned long backing planes; 
unsigned long backing pixel; 


Bool save_under; 
long event_mask; 


long do not propagate mask; 
Bool override redirect; 


Colormap colormap; 
Cursor cursor; 
} XSetWindowAttributes; 


/* Definitions for valuemask argument 


#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 


CWBackPixmap 
CWBackPixel 
CWBorderPixmap 
CWBorderPixel 
CWBitGravity 
CWWinGravity 
CWBackingStore 
CWBackingPlanes 
CWBackingPixel 
CWOverrideRedirect 
CWSaveUnder 
CWEventMask 
CWDontPropagate 
CWColormap 
CWCursor 
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/* 
/* 
/* 
/* 
/* 
/* 
/* 
/* 
/* 
/* 
/* 
/* 
/* 


pixmap, None, or ParentRelative */ 
background pixel */ 

pixmap, None, or CopyFromParent */ 
border pixel value */ 

one of bit gravity values */ 

one of the window gravity values */ 
NotUseful, WhenMapped, Always */ 

planes to be preseved if possible */ 
value to use in restoring planes */ 
should bits under be saved (popups) */ 
set of events that should be saved */ 
set of events that should not propagate */ 
override redirected config request */ 
colormap to be associated with window */ 
cursor to be displayed (or None) */ 


of CreateWindow and ChangeWindowAttributes */ 


(1L<<0) 
(a5 <<) 
(T<<2') 
(1L<<3) 
(1L<<4) 
(di<<5) 
(1L<<6) 
Giuinc<7)) 
(1L<<8) 
(1L<<9) 
(1L<<10) 
(1L<<11) 
(1L<<12) 
(Gi<<il3)) 
(1L<<14) 
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Errors 


BadAccess 
BadColormap 
BadCursor 
BadMatch 
BadPixmap 
BadValue 
BadWindow 


Related Commands 
XGetGeomet ry, XGetWindowAttributes, XSetWindowBackground, XSet- 
WindowBackgroundPixmap, XSetWindowBorder, XSetWindowBorderPixmap. 
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Name 
XChecklIfEvent — check the event queue for a matching event. 


Synopsis 
Bool XCheckIfEvent (display, event, predicate, arg) 
Display *display; 
XEvent *event; /* RETURN */ 
Bool (*predicate) (); 
char “arg; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
event Returns the matched event. 


predicate Specifies the procedure that is called to determine if the next event matches 
your criteria. 


arg Specifies the user-specified argument that will be passed to the predicate pro- 
cedure. 


Description 
XCheckIfEvent returns the next event in the queue that is matched by the specified predi- 
cate procedure. If found, that event is removed from the queue, and True is returned. If no 
match is found, XCheckIfEvent returns False and flushes the request buffer. No other 
events are removed from the queue. Later events in the queue are not searched. 


The predicate procedure is called with the arguments display, event, and arg. 


For more information, see Volume One, Chapter 8, Events. 


Related Commands 
QLength, XAllowEvents, XCheckMaskEvent, XCheckTypedEvent, XCheck- 
TypedWindowEvent, XCheckWindowEvent, XEventsQueued, XGet InputFocus, 
XGetMotionEvents, XIfEvent, XMaskEvent, XNextEvent, XPeekEvent, XPeek- 
IfEvent, XPending, XPutBackEvent, XSelect Input, XSendEvent, XSetInput- 
Focus, XSynchronize, XWindowEvent. 
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Name 
XCheckMaskEvent — remove the next event that matches mask; don’t wait. 


Synopsis 
Bool XCheckMaskEvent (display, event_mask, event) 
Display *display; 
long event_mask; 


XEvent *event; /* RETURN */ 
Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 


event_mask Specifies the event types to be returned. See list under XSelect Input. 
event Returns a copy of the matched event’s XEvent structure. 


Description 
XCheckMaskEvent removes the next event in the queue that matches the passed mask. The 
event is copied into an XEvent supplied by the caller and XCheckMaskEvent returns 
True. Other events earlier in the queue are not discarded. If no such event has been queued, 
XCheckMaskEvent flushes the request buffer and immediately returns False, without wait- 
ing. 


For more information, see Volume One, Chapter 8, Events. 


Related Commands 
QLength, XAllowEvents, XCheckIfEvent, XCheckTypedEvent, XCheckTyped- 
WindowEvent, XCheckWindowEvent, XEvent sQueued, XGet InputFocus, XGet- 
MotionEvents, XIfEvent, XMaskEvent, XNextEvent, XPeekEvent, XPeek- 
IfEvent, XPending, XPutBackEvent, XSelect Input, XSendEvent, xSet Input- 
Focus, XSynchronize, XWindowEvent. 
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Name 5 
XCheckTypedEvent — return the next event in queue that matches event type; don’t wait. 


Synopsis 
Bool XCheckTypedEvent (display, event_type, report) 
Display *display; 
int event_type; 


XEvent *report; /* RETURN */ 
Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 


event type Specifies the event type to be compared. 
report Returns a copy of the matched event structure. 


Description 
XCheckTypedEvent searches first the event queue, then the events available on the server 
connection, for the specified event_type. If there is a match, it returns the associated event 
structure. Events searched but not matched are not discarded. XCheckTypedEvent returns 
True if the event is found. If the event is not found, XCheckTypedEvent flushes the 
request buffer and returns False. 


This command is similar to XCheckMaskEvent, but it searches through the queue instead of 
inspecting only the last item on the queue. It also matches only a single event type instead of 
multiple event types as specified by a mask. 


For more information, see Volume One, Chapter 8, Events. 


Related Commands 
QLength, XAllowEvents, XCheckIfEvent, XCheckMaskEvent, XCheckTyped- 
WindowEvent, XCheckWindowEvent, XEvent sQueued, XGet InputFocus, XGet- 
MotionEvents, XIfEvent, XMaskEvent, XNextEvent, XPeekEvent, XPeek- 
IfEvent, XPending, XPutBackEvent, XSelectInput, XSendEvent, XSetInput- 
Focus, XSynchronize, XWindowEvent. 
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Name 
XCheckTypedWindowE vent — return the next event in queue matching type and window. 


Synopsis 
Bool XCheckTypedWindowEvent (display, w, event_type, report) 
Display *display; 
Window w; 
int event_type; 


XEvent *report; /* RETURN */ 
Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
w Specifies the window ID. 


event_type Specifies the event type to be compared. 


report Returns the matched event’s associated structure into this client-supplied 
structure. 


Description 
XCheckTypedWindowEvent searches first the event queue, then any events available on 
the server connection, for an event that matches the specified window and the specified event 
type. Events searched but not matched are not discarded. 


XCheckTypedWindowEvent returns True if the event is found; it flushes the request buffer 
and returns False if the event is not found. 


For more information, see Volume One, Chapter 8, Events. 


Related Commands 
QLength, XAllowEvents, XCheckIfEvent, XCheckMaskEvent, XCheckTyped- 
Event, XCheckWindowEvent, XEventsQueued, XGet InputFocus, XGetMotion- 
Events, XIfEvent, XMaskEvent, XNextEvent, XPeekEvent, XPeekIfEvent, 
XPending, XPutBackEvent, XSelectInput, XSendEvent, XSetInputFocus, 
XSynchronize, XWindowEvent. 
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Name 
XCheckWindowEvent — remove the next event matching both passed window and passed 
mask; don’t wait. 


Synopsis 
Bool XCheckWindowEvent (display, w, event_mask, event) 
Display *display; 
Window w; 
long event_mask; 


XEvent *event; /* RETURN */ 
Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
w Specifies the window ID. The event must match both the passed window and 


the passed event mask. 
event_mask Specifies the event mask. See XSelect Input for a list of mask elements. 
event Returns the XEvent structure. 


Description 
XCheckWindowEvent removes the next event in the queue that matches both the passed 
window and the passed mask. If such an event exists, it is copied into an XEvent supplied by 
the caller. Other events earlier in the queue are not discarded. 


If a matching event is found, XCheckWindowEvent returns True. If no such event has been 
queued, it flushes the request buffer and returns False, without waiting. 


For more information, see Volume One, Chapter 8, Events. 


Related Commands 
QLength, XAllowEvents, XCheckIfEvent, XCheckMaskEvent, XCheckTyped- 
Event, XCheckTypedWindowEvent, XEventsQueued, XGet InputFocus, XGet- 
MotionEvents, XIfEvent, XMaskEvent, XNextEvent, XPeekEvent, XPeek- 
IfEvent, XPending, XPutBackEvent, XSelectInput, XSendEvent, XSetInput- 
Focus, XSynchronize, XWindowEvent. 
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Name 
XCirculateSubwindows — circulate the stacking order of children up or down. 


Synopsis 
XCirculateSubwindows (display, w, direction) 
Display *display; 
Window w; 
int direction; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
w Specifies the window ID of the parent of the subwindows to be circulated. 


direction _ Specifies the direction (up or down) that you want to circulate the children. 
Pass either RaiseLowest or LowerHighest. 


Description 

XCirculateSubwindows circulates the children of the specified window in the specified 
direction, either RaiseLowest or LowerHighest. If some other client has selected 
Subst ructureRedirectMask on the specified window, then a CirculateRequest 
event is generated, and no further processing is performed. If you specify RaiseLowest, this 
function raises the lowest mapped child (if any) that is occluded by another child to the top of 
the stack. If you specify LowerHighest, this function lowers the highest mapped child (if 
any) that occludes another child to the bottom of the stack. Exposure processing is performed 
on formerly obscured windows. 


For more information, see Volume One, Chapter 14, Window Management. 


Errors 
BadValue 
BadWindow 


Related Commands 
XCirculateSubwindowsDown, XCirculateSubwindowsUp, XConfigureWindow, 
XLowerWindow, XMoveResizeWindow, XMoveWindow, XQueryTree, XRaise- 
Window, XReparentWindow, XResizeWindow, XRestackWindows. 
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Name ; 
XCirculateSubwindowsDown — circulate the bottom child to the top of the stacking order. 
Synopsis 
XCirculateSubwindowsDown (display, w) 
Display *display; 


Window w; 
Arguments 
display Specifies a connection to‘an X server; returned from XOpenDisplay. 
w Specifies the window ID of the parent of the windows to be circulated. 
Description 


XCirculateSubwindowsDown lowers the highest mapped child of the specified window 
that partially or completely obscures another child. The lowered child goes to the bottom of the 
stack. Completely unobscured children are not affected. 


This function generates exposure events on any window formerly obscured. Repeated execu- 
tions lead to round-robin lowering. This is equivalent to XCirculateSubwindows (dis- 
play, w, LowerHighest). 


If some other client has selected SubstructureRedirectMask on the window, then a 
CirculateRequest event is generated, and no further processing is performed. This allows 
the window manager to intercept this request when w is the root window. Usually, only the 
window manager will call this on the root window. 


For more information, see Volume One, Chapter 14, Window Management. 


Errors 
BadWindow 


Related Commands 
XCirculateSubwindows, XCirculateSubwindowsUp, XConfigureWindow, 
XLowerWindow, XMoveResizeWindow, XMoveWindow, XQueryTree, XRaise- 
Window, XReparentWindow, XResizeWindow, XRestackWindows. 
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Name 
XCirculateSubwindowsUp — circulate the top child to the bottom of the stacking order. 


Synopsis 
XCirculateSubwindowsUp (display, w) 
Display *display; 
Window w; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
w Specifies the window ID of the parent of the windows to be circulated. 
Description 


XCirculateSubwindowsUp raises the lowest mapped child of the specified window that is 
partially or completely obscured by another child, The raised child goes to the top of the stack. 
Completely unobscured children are not affected. This generates exposure events on the raised 
child (and its descendents, if any). Repeated executions lead to round robin-raising. This is 
equivalent to XCirculateSubwindows (display, w, RaiseLowest). 


If some other client has selected Subst ructureRedirectMask on the window, then a 
CirculateRequest event is generated, and no further processing is performed. This allows 
the window manager to intercept this request when w is the root window. Usually, only the 
window manager will call this on the root window. 


For more information, see Volume One, Chapter 14, Window Management. 


Errors 
BadWindow 


Related Commands 
XCirculateSubwindows, XCirculateSubwindowsDown, XConfigureWindow, 
XLowerWindow, XMoveResizeWindow, XMoveWindow, XQueryTree, XRaise- 
Window, XReparentWindow, XResizeWindow, XRestackWindows. 
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Name 
XClearArea — clear a rectangular a area in a wihdow. 


Synopsis 
XClearArea (display, w, x, y, width, height, exposures) 
Display *display; 
Window w; 
LEN XN V7 
unsigned int width, oagnts 
Bool exposures; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
w Specifies the ID of an Input Output window. 
x Specify the x and y coordinates of the upper-left corner of the rectangle to be 
y cleared, relative to the origin of the window. 
width Specify the dimensions in pixels of the rectangle to be cleared. 
height 


exposures Specifies whether exposure events are generated. Must be either True or 
False. 


Description 
XClearArea Clears a rectangular area in a window. 


If width is zero, the window is cleared from x to the right edge of the window. If height is 
zero, the window is cleared from y to the bottom of the window. See figure above.. 


If the window has a defined background tile or it is ParentRelative, the rectangle is tiled 
with a plane_mask of all 1’s, a function of Gxcopy, and a subwindow_mode of 
ClipByChildren. If the window has background None, the contents of the window are not 
changed. In either case, if exposures is True, then one or more exposure events are gen- 
erated for regions of the rectangle that are either visible or are being retained in a backing store. 


For more information, see Volume One, Chapter 6, Drawing Graphics and Text. 
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Window Window 





Window 





Errors 
BadMatch Window is an Input On1y class window. 


BadValue 
BadWindow 


Related Commands 
XClearWindow, XCopyArea, XCopyPlane, XDraw, XDrawArc, XDrawArcs, XDraw- 
Filled, XDrawLine, XDrawLines, XDrawPoint, XDrawPoints, XDrawRectangle, 
XDrawRectangles, XDrawSegments, XFillArc, XFillArcs, XFillPolygon, 
XFillRectangle, XFillRectangles. 


~ 
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Name : 
XClearWindow — clear an entire window. é 


Synopsis 
XClearWindow (display, w) 
Display *display; 
Window w; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
w Specifies the ID of the window to be cleared. 

Description 


XClearWindow clears a window, but does not cause exposure events. This function is equiv- 
alent to XClearArea (display, w, 0, 0, 0, 0, False). 


_ If the window has a defined background tile or it is ParentRelative, the rectangle is tiled 
with a plane _mask of all 1’s and function of GXcopy. If the window has background 
None, the contents of the window are not changed. 


For more information, see Volume One, Chapter 6, Drawing Graphics and Text. 
Errors 

BadMatch If wis an InputOn1y class window. 

BadValue 

BadWindow 


Related Commands 
XClearArea, XCopyArea, XCopyPlane, XDraw, XDrawArc, XDrawArcs, XDraw- 
Filled, XDrawLine, XDrawLines, XDrawPoint, XDrawPoints, XDrawRectangle, 
XDrawRectangles, XDrawSegments, XFillArc, XFillArcs, XFillPolygon, 
XFillRectangle, XFillRectangles. 
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XClipBox Xlib — Regions— 


Name 
XClipBox — generate the smallest rectangle enclosing a region. 


Synopsis 
XClipBox(r, rect) 
Region r; 
XRectangle *rect; /* RETURN */ 


Arguments 
ee Specifies the region. 


rect Returns the smallest rectangle enclosing region r. 


Description 
XC1ipBox returns the smallest rectangle that encloses the given region. 


For more information, see Volume One, Chapter 6, Drawing Graphics and Text. 


Structures 
Region is a pointer to an opaque structure type. 


Related Commands 
XCreateRegion, XDestroyRegion, XEmptyRegion, XEqualRegion, 
XIntersectRegion, xOffsetRegion, XPointInRegion, XPolygonRegion, 
XRect InRegion, XSetRegion, XShrinkRegion, XSubt ractRegion, XUnion- 
RectWithRegion, XUnionRegion, XXorRegion. 
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Name : 
XCloseDisplay — disconnect a client program from an X server and display. 


Synopsis 
XCloseDisplay (display) 
Display *display; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 


Description 
XCloseDisplay closes the connection between the current client and the X server specified 
by the Display argument. 


The XCloseDisplay routine destroys all windows, resource IDs (Window, Font, Pixmap, 
Colormap, Cursor, and GContext), or other resources (GCs) that the client application 
has created on this display, unless the close down mode of the client’s resources has been 
changed by XSetCloseDownMode. Therefore, these windows, resource IDs, and other 
resources should not be referenced again. In addition, this routine discards any requests that 
have been buffered but not yet sent to the server. 


Although these operations automatically (implicitly) occur when a process exits under UNIX, 
you should call XCloseDisplay anyway. 


For more information, see Volume One, Chapter 3, Basic Window Program. 


Related Commands 
DefaultScreen, XFree, XNoOp, XOpenDisplay. 
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XConfigureWindow Xlib — Window Manipulation — 


Name 


XConfigureWindow — change the window position, size, border width, or stacking order. 


Synopsis 


XConfigureWindow (display, w, value_mask, values) 
Display *display; 
Window w; 
unsigned int value_mask; 
XWindowChanges *values; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
Ww Specifies the ID of the window to be reconfigured. 


value_mask Specifies which values are to be set using information in the values struc- 
ture. value_mask is the bitwise OR of any number of symbols listed in the 
Structures section below. 


values Specifies a pointer to the XWindowChanges structure containing new confi- 
guration information. See the Structures section below. 


Description 


90 


XConfigureWindow changes the window position, size, border width, and/or the stacking 
order. If selected, aConfigureNotify event is generated to announce any changes. 


If the window to be reconfigured is a top-level window, there will be interaction with the win- 
dow manager if the override_redirect attribute of the window is False. In this case, 
the X server sends a ConfigureRequest event to the window manager and does not recon- 
figure the window. The window manager receives this event and then makes the decision 
whether to allow the application to reconfigure its window. The client should wait for the 
ConfigureNotify event to find out the size and position of the window. 


In Release 4, XReconfigureWMWindow should be used instead of XConfigureWindow 
for top-level windows. This routine handles restacking of top-level windows properly. 


If a window’s size actually changes, the window’s subwindows may move according to their 
window gravity. If they do, GravityNotify events will be generated for them. Depending 
on the window’s bit gravity, the contents of the window also may be moved. See Volume One, 
Chapter 4, Window Attributes for further information. 


Exposure processing is performed on formerly obscured windows, including the window itself 
and its inferiors, if regions of them were obscured but afterward are not. As a result of increas- 
ing the width or height, exposure processing is also performed on any new regions of the win- 
dow and any regions where window contents are lost. 


The members of XWindowChanges that you specify in values are: 
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x 
+ 


width 
height 


Specify the x and y coordinates of the upper-left outer corner of the window 


relative to the parent’s origin.’ 


Specify the inside size of the window in pixels, not including the border. 


These arguments must be positive. 


border width 


Sibling 


stack_mode 


Specifies the width of the border in pixels. 


Specifies the sibling window for stacking operations. If not specified, no 
change in the stacking order will be made. If specified, stack_mode must 


also be specified. 


The stack mode can be any of these constants: Above, Below, TopIf, 


BottomIf, or Opposite. 


The computation for the BottomIf, TopIf, and Opposite stacking modes is performed 
with respect to window w’s final size and position (as controlled by the other arguments to 
XConfigureWindow, not its initial position.) It is an error if sibling is specified without 
stack_mode. If sibling and stack_mode are specified, the window is restacked as fol- 


lows: 
Stacking Flag 
Above 
Below 


Toplf 
BottomIf 


Opposite 
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Position 
w is placed just above sibling 
w is placed just below sibling 


if sibling obscures w, then w is placed at the top 
of the stack 


if w obscures sibling, then w is placed at the bot- 
tom of the stack 


if sibling occludes w, then w is placed at the top 
of the stack. If w occludes sibling, then w is 
placed at the bottom of the stack. If wand sibling 
do not overlap, no change is made. 
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If a stack_mode is specified but no sibling is specified, the window is restacked as follows: 


Stacking Flag 
Above 


Below 
Top Ise 


BottomIf 


Opposite 





Position 













w is placed at the top of the stack 
w is placed at the bottom of the stack 


if any sibling obscures w, then w is placed at the top 
of the stack 

if w obscures any sibling, then window is placed at 
the bottom of the stack 

if any sibling occludes w, then w is placed at the top 
of the stack, else if w occludes any sibling, then w is 
placed at the bottom of the stack 





Under Release 4, use XReconfigureWMWindow to configure a top-level window. 


Structures 


typedef struct { 


pistes 


y; 


int width, height; 
int border width; 
Window sibling; 
int stack_mode; 

} XWindowChanges; 


/* ConfigureWindow structure */ 
/* ChangeWindow value bits definitions for valuemask */ 


#define CWX (1<<0) 

#define CWY lea) 

#define CWWidth (1i<<2) 

#define CWHeight (U<<3)) 

#define CWBorderWidth (1<<4) 

#define CWSibling (1<<5) 

#define CWStackMode (1<<6) 

Errors 

BadMatch Attempt to set any invalid attribute of Input Only window. 
sibling specified without a stack_mode. 
The sibling window is not actually a sibling. 

BadValue widthor height is 0. 

BadWindow 
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Related Commands 
XCirculateSubwindows, XCirculateSubwindowsDown, XCirculate- 
SubwindowsUp, XLowerWindow, XMoveResizeWindow, XMoveWindow, XQuery- 
Tree, XReconfigureWMWindow, XRaiseWindow, XReparentWindow, XResize- 


Window, XRestackWindows. 
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XConvertSelection \ siti eee ce 


Name 
XConvertSelection — use the value of a selection. 


Synopsis 
XConvertSelection (display, selection, target, property, 
requestor, time) 
Display *display; 
Atom selection, target; 
Atom property; /* may be None */ 
Window requestor; 
‘Time time; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 


selection — Specifies the selection atom. XA_PRIMARY and XA_SECONDARY are the stan- 
dard selection atoms. 


target Specifies the atom of the type property that specifies the desired format for 
the data. 


property Specifies the property in which the requested data is to be placed. None is 
also valid, but current conventions specify that the requestor is in a better 
position to select a property than the selection owner. 


requestor Specifies the requesting window. 


time Specifies the time when the conversion should take place. Pass either a 
timestamp, expressed in milliseconds, or the constant Current Time. 


Description 
XConvertSelection causes a SelectionRequest event to be sent to the current selec- 
tion owner if there is one, specifying the property to store the data in (selection), the format 
to convert that data into before storing it (target), the property to place the information in 
(property), the window that wants the information (requestor), and the time to make the 
conversion (time). 


The selection owner responds by sending a SelectionNotify event, which confirms the 
selected atom and type. If no owner for the specified selection exists, or if the owner could not 
convert to the type specified by requestor, the X server generates or the owner sends a 
SelectionNotify event to the requestor with property None. Whether or not the owner 
exists, the arguments are passed unchanged. See Volume One, Chapter 10, Jnterclient Commu- 
nication, for a description of selection events and selection conventions. 


Errors 
BadAtom 
BadWindow 


Related Commands 
XGetSelectionOwner, XSetSelectionOwner. 
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Name b> 
XCopyArea — copy an area of a drawable. 


Synopsis 
XCopyArea (display, src, dest, gc, src_x, src_y, width, 
height, dest_x, dest_y) 
Display *display; 
Drawable src, dest; 
GE) gC; 
int Sree, SrCuyi 
unsigned int width, height; 
int dest x, dest_y; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
Sree Specify the source and destination rectangles to be combined. src and 
dest — dest must have the same root and depth. 
gc Specifies the graphics context. 
Srco_x Specify the x and y coordinates of the upper-left corner of the source rectan- 
src.y gle relative to the origin of the source drawable. 
width Specify the dimensions in pixels of both the source and destination rectan- 
height gles. 
dest_x Specify the x and y coordinates within the destination window. 
dest_y 
Description 


XCopyArea combines the specified rectangle of src with the specified rectangle of dest. 
src and dest must have the same root and depth. 


If regions of the source rectangle are obscured and have not been retained in back- 
ing_store, or if regions outside the boundaries of the source drawable are specified, then 
those regions are not copied. Instead, the following occurs on all corresponding destination 
regions that are either visible or are retained in backing_store. If dest is a window with 
a background other than None, the corresponding regions of the destination are tiled (with 
plane_mask of all 1’s and function GXcopy) with that background. Regardless of tiling, if 
the destination is a window and graphics_exposures in gc is True, then Graphics- 
Expose events for all corresponding destination regions are generated. If graph- 
ics exposures is True but no regions are exposed, then a NoExpose event is generated. 


If regions of the source rectangle are not obscured and graphics exposures is False, 
one NoExpose event is generated on the destination. 
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XCopyArea (continued) Xlib — Drawing Primitives 


XCopyArea uses these graphics context components: function,plane mask, 
subwindow_mode, graphics exposures,clip x origin,clip_y origin, and 
clip_mask. 


Errors 
BadDrawable 
BadGC 
BadMatch The src and dest rectangles do not have the same root and depth. 
Related Commands 
XClearArea, XClearWindow, XCopyPlane, XDraw, XDrawArc, XDrawArcs, 
XDrawFilled, XDrawLine, XDrawLines, XDrawPoint, XDrawPoints, XDraw- 


Rectangle, XDrawRectangles, XDrawSegments, XFillArc, XFillArcs, XFill- 
Polygon, XFillRectangle, XFillRectangles. 
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Name 
XCopyColormapAndFree — copy a colormap and return a new colormap ID. 


Synopsis 
Colormap XCopyColormapAndFree (display, cmap) 
Display *display; 
Colormap cmap; 


_ Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
cmap Specifies the colormap you are moving out of. 
Description 


XCopyColormapAndF ree is used to obtain a new virtual colormap when allocating color- 
cells out of a previous colormap has failed due to resource exhaustion (that is, too many cells or 
planes were in use in the original colormap). 


XCopyColormapAndFree moves all of the client’s existing allocations from cmap to the 
returned Colormap and frees those entries in cmap. The visual type and screen for the new 
colormap is the same as for the old. 


If cmap was created by the client with the alloc argument set to AllocA11, the new color- 
map is also created with AllocA11, all color values for all entries are copied from cmap, and 
then all entries in cmap are freed. 


If cmap was created by the client with AllocNone, the allocations to be moved are all those 
pixels and planes that have been allocated by the client using XAllocColor, XAlloc- 
NamedColor, XAllocColorCells, or XAllocColorPlanes and that have not been 
freed since they were allocated. Values in other entries of the new Colormap are undefined. 


For more information, see Volume One, Chapter 7, Color. 


Errors 
BadAlloc 
BadColormap 


Related Commands 
DefaultColormap, DisplayCells, XCreateColormap, XFreeColormap, XGet- 
StandardColormap, XInstallColormap, XListInstalledColormaps, XSet- 
StandardColormap, XSetWindowColormap, XUninstallColormap. 
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XCopyGC | Xlib —- Graphics Context— 


Name 


XCopyGC — copy a graphics context. 


Synopsis 


XCopyGC (display, src, valuemask, dest) 


Display *display; 
GC src, dest; 


unsigned long valuemask; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
~ . SFC Specifies the components of the source graphics context. 


valuemask _ Specifies the components in the source GC structure to be copied into the des- 
tination GC. valuemask is made by combining any number of the mask 
symbols listed in the Structures section using bitwise OR (|). 


dest Specifies the destination graphics context. 


Description 


XCopyGC copies the selected elements of one graphics context to another. See Volume One, 
Chapter 5, The Graphics Context, for a description of the graphics context. 


Structures 


The GC structure contains the following elements: 


/* 


* Data structure for setting graphics context. 


oy 
typedef struct { 
ini mEuNetdony 
unsigned long plane mask; 
unsigned long foreground; 


unsigned long background; 


int Maine mwiete hy 

aligne “hakinisy Bheyylliese 

int Caplstyle; 

Vite One siay Ley 
IneeRvieist yes 

dnt, pee mdie 7 

int arc mode; 
Pixmap tile; 

Pixmap stipple; 

Die te Se oR OnCiains 
ees Yanan, 
HONE s homey 

int subwindow_mode; 
Bool graphics exposures; 
ine clip x originy 


98 


/* 
/* 
/* 
/* 
/* 
/* 
/* 
/* 
/* 
/* 
/* 
/* 
ae 
/* 


/* 
/* 
/* 
/* 


logical operation */ 

plane mask */ 

foreground pixel */ 

background pixel */ 

line width */ 

Solid, OnOffDash, DoubleDash */ 
NotLast, Butt, Round, Projecting */ 
Miter, Round, Bevel */ 

Solid, Tiled, Stippled */ 

EvenOdd, Winding */ 

PieSlice */ 

tile pixmap for tiling operations */ 
stipple 1 plane pixmap for stipping */ 
offset for tile or stipple operations */ 


default text font for text operations */ 
ClipByChildren, IncludeInferiors */ 
boolean, should exposures be generated */ 
OrIGiin for eluispumc*/ 
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Ine elipey Organi; 
Pixmap clip mask; 
int dash offset; 
char dashes; 

} XGCValues; 


#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 


Errors 


GCFunction 
GCP laneMask 
GCForeground 
GCBackground 
GCLineWidth 
GCLineStyle 
GCCapStyle 
GCJoinStyle 
GCFillStyle 
GCFillRule 
GCTile 
GCStipple 
GCTileStipXOrigin 


‘GCTileStipYOrigin 


GCFont 
GCSubwindowMode 
GCGraphicsExposures 
GCClipXOrigin 
GCClipYOrigin 
GCClipMask 
GCDashOffset 
GCDashList 
GCArcMode 


BadAlloc 


BadGC 


BadMatch 


Related Commands 
DefaultGC, XChangeGC, XCreateGC, XFreeGC, XGContextFromGC, XGet- 


GCValues, XSetArcMode, XSetBackground, XSetClipMask, XSetClipOrigin, 
XSetClipRectangles, XSetDashes, XSetFillRule, XSetFillStyle, xSet- 


(continued) XCopyGC 


/* bitmap clipping; other calls for rects */ 


/* patterned/dashed line information */ 


(1L<<0) 
(1L<<1) 
(1L<<2) 
(1L<<3) 
(1L<<4) 
(1L<<5) 
(1L<<6) 
(1L<<7) 
(1L<<8) 
(1L<<9) 
(1<<1/0') 
(1i<<11) 
(dh<<i 2) 
(1L<<13) 
(1L<<14) 
(1L<<15) 
(1L<<16) 
(1L<<17) 
(1L<<18) 
(1L<<19) 
(1L<<20) 
(2L<<21) 
(1S<295 


sxc and dest do not have the same root and depth. 


Foreground, XSetFunction, XSetGraphicsExposures, XSetLineAttributes, 
XSetPlaneMask, XSetState, XSetStipple, xSet SubwindowMode, XSet- 
TSOrigin. 
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XCopyPlane Xlib — Drawing Primitives— 


Name 
XCopyPlane — copy a single plane of a drawable into a drawable with depth, applying pixel 
values. 
Synopsis 


XCopyPlane (display, src, dest, gc, src_x, src_y, width, 
height, dest_x, dest_y, plane) 
Display *display; 
Drawable src, dest; 
GE. gc; 
ine fe x, S6C_y; 
unsigned int width, height; 
int dest.x, dest_y; 
unsigned long plane; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
SIC Specify the source and destination drawables. 
dest 
gc Specifies the graphics context. 
pe BoC 36 Specify the x and y coordinates of the upper-left corner of the source rectan- 
SLCAV gle relative to the origin of the drawable. 
width Specify the width and height in pixels. These are the dimensions of both the 
height source and destination rectangles. 
dest_x Specify the x and y coordinates at which the copied area will be placed rela- 
dest_y tive to the origin of the destination drawable. 
plane Specifies the source bit-plane. You must set exactly one bit, and the bit must 
specify a plane that exists in src. 
Description 


XCopyP lane copies a single plane of a rectangle in the source into the entire depth of a corre- 
sponding rectangle in the destination. The plane of the source drawable and the fore- 
ground/background pixel values in gc are combined to form a pixmap of the same depth 
as the destination drawable, and the equivalent of an XCopyArea is performed, with all the 
same exposure semantics. 


XCopyP lane uses these graphics context components: function, plane_mask, 
foreground, background, subwindow_mode, graphics exposures, 
clip _x origin,clip_y origin,andclip mask. 


The src and dest drawables must have the same root, but need not have the same depth. 


For more information, see Volume One, Chapter 5, The Graphics Context. 
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Errors 
BadDrawable ‘ 
BadGC 
BadMatch src and dest do not have the same root. 
BadValue plane does not have exactly one bit set, or bit specified in plane is nota 


plane in src. 


Related Commands 
XClearArea, XClearWindow, XCopyArea, XDraw, XDrawArc, XDrawArcs, XDraw- 
Filled, XDrawLine, XDrawLines, XDrawPoint, XDrawPoints, XDrawRectangle, 
XDrawRectangles, XDrawSegments, XFillArc, XFillArcs, XFillPolygon, 
XFillRectangle, XFillRectangles. 


Xlib Reference Manual ; 101 


XCreateAssocTable Xlib — Association Tables— 


Name 
XCreateAssocTable — create a new association table (X10). 


Synopsis 
XAssocTable *XCreateAssocTable (size) 
int size; 


Arguments 
size Specifies the number of buckets in the hashed association table. 


Description 
XCreateAssocTable creates an association table, which allows you to associate your own 
structures with X resources in a fast lookup table. This function is provided for compatibility 
with X Version 10. To use it you must include the file <X/1/X10.h> and link with the library 
-loldX. 


The size argument specifies the number of buckets in the hash system of XAssocTable. 
For reasons of efficiency the number of buckets should be a power of two. Some size sugges- 
tions might be: use 32 buckets per 100 objects; a reasonable maximum number of object per 
buckets is 8. 


If there is an error allocating memory for the XAssocTab1e, a NULL pointer is returned. 


For more information on association tables, see Volume One, Appendix B, X10 Compatibility. 


Structures 
typedef struct { 
XAssoc *buckets; /* pointer to first bucket in array */ 
imt sizes 7/* table size (number of buckets) */ 


} XAssocTable; 


Related Commands 
XDeleteAssoc, XDestroyAssocTable, XLookUpAssoc, XMakeAssoc. 
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—Xlib — Pixmaps and Tiles XCreateBitmapFromData 


Name 
XCreateBitmapFromData — create a bitmap from X11 bitmap format data. 


Synopsis 
Pixmap XCreateBitmapFromData(display, drawable, data, 
width, height) 
Display *display; 
Drawable drawable; 
chan) *data; 
unsigned int width, height; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
drawable Specifies a drawable. This determines which screen to create the bitmap on. 
data Specifies the bitmap data, in X11 bitmap file format. 
wach”. Specify the dimensions in pixels of the created bitmap. If smaller than the 
height bitmap data, the upper-left corner of the data is used. 

Description 


XCreateBitmapFromData creates a single-plane pixmap from an array of hexadecimal 
data. This data may be defined in the program or included. The bitmap data must be in X ver- 
sion 11 format as shown below (it cannot be in X10 format). The following format is assumed 
for the data, where the variables are members of the XImage structure described in Volume 
One, Chapter 6, Drawing Graphics and Text: 


format=XYPixmap 
bit_order=LSBFirst 

byte order=LSBFirst 
bitmap_unit=8 

bitmap pad=8 

xoffset=0 

no extra bytes per line 


XCreateBitmapFromData creates an image with the specified data and copies it into the 
created pixmap. The following is an example of creating a bitmap: 


#define gray width 16 

#define gray height 16 

#define gray x hot 8 

#define gray y hot 8 

static char gray bits[] = { 
Ox687. Oxd tt, n0xe3, 5 OXCi, 2OXGt a OxXha A iOxOr, Oxi 9 
Oxo Oxid, OxSs  0xee, WOR, Oxre, Oxf Oxte, 
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Ox7e, Ox7e, Ox7f£, Oxfe, Ox37, Oxec, Oxbb, Oxdd, 
0x96; JOx39 pO xciaOx€Si7- Oxe3,,cOxci/, .Oxf8, Oxi}; 


Pixmap XCreateBitmapFromData(display, window, gray bits, 
gray width, gray height); 


If the call could not create a pixmap of the requested size on the server, XCreateBitmap- 
FromData returns 0 (zero), and the server generates a BadAlloc error. If the requested 
depth is not supported on the screen of the specified drawable, the server generates a Bad- 
Match error. 


The user should free the bitmap using XF reePixmap when it is no longer needed. 


For more information, see Volume One, Chapter 6, Drawing Graphics and Text. 


Errors 
BadAlloc Server has insufficient memory.to create bitmap. 
BadDrawable 
BadValue Specified bitmap dimensions are zero. 


Related Commands 
XCreatePixmap, XCreatePixmapFromBitmapData, XCreatePixmapFrom- 
BitmapData, XFreePixmap, XQueryBestSize, XQueryBestStipple, XQuery- 
BestTile, XReadBitmapFile, XSetTile, XSetWindowBackgroundPixmap, 
XSetWindowBorderPixmap, XWriteBitmapFile. 
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Name ; 
XCreateColormap — create a colormap. ‘ 


Synopsis 
Colormap XCreateColormap (display, w, visual, alloc) 
Display *display; 
Window w; 
Visual *visual; 
Bugs ellakeyess 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
w Specifies a window ID. The colormap created will be associated with the 
same screen as the window. 
visual Specifies a pointer to the Visual structure for the colormap. The visual 
class and depth must be supported by the screen. 
alloc Specifies how many colormap entries to allocate. Pass either AllocNone or 
AllocAll. 
Description 


XCreateColormap creates a colormap of the specified visual type and allocates either none 
or all of its entries, and returns the colormap ID. 


It is legal to specify any visual class in the structure pointed to by the visual argument. If the 
class is StaticColor, StaticGray, or TrueColor, the colorcells will have pre-allocated 
read-only values defined by the individual server but unspecified by the X11 protocol. In these 
cases, alloc must be specified as AllocNone (else a BadMat ch error). 


For the other visual classes, PseudoColor, DirectColor, and GrayScale, you can pass 
either AllocAll or AllocNone to the alloc argument. If you pass AllocNone, the 
colormap has no allocated entries. This allows your client programs to allocate read-only 
colorcells with XAllocColor or read/write cells with XAllocColorCells, Alloc- 
ColorPlanes and XStoreColors. If you pass the constant AllocA11, the entire color- 
map is allocated writable (all the entries are read/write, nonshareable and have undefined initial 
RGB values), and the colors can be set with XStoreColors. However, you cannot free these 
entries with XFreeColors, and no relationships between the entries are defined. 


If the visual class is PSseudoColor or GrayScale and alloc is AllocA11, this function 
simulates a call to the function XAllocColor cells returning all pixel values from 1 to 
(map entries - 1). Fora visual class of DirectColor, the processing for ALlocAl1 
simulates a call to the function XAllocColorPlanes, returning a pixel value of 0 and mask 
values the same as the red_mask, green_mask, andblue_mask members in visual. 
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The visual argument should be as returned from the DefaultVisual macro, XMatch- 
VisualiInfo, or XGetVisuallinfo. 


If the hardware colormap on the server is immutable, and therefore there is no possibility that a 
virtual colormap could ever be installed, xcreateColormap returns the default colormap. 
Code should check the returned ID against the default colormap to catch this situation. 


For more information on creating colormaps, see Volume One, Chapter 7, Color. 


Errors 
BadAlloc 
BadMatch Didn’t use AllocNone for StaticColor, StaticGray, or True- 
Covor. 
visual type not supported on screen. 
BadValue 
BadWindow 


Related Commands 
DefaultColormap, DisplayCells, XCopyColormapAndF ree, XFreeColormap, 
XGetStandardColormap, XInstallColormap, XListInstalledColormaps, 
XSetStandardColormap, XSetWindowColormap, XUninstallColormap. 
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Name : 
XCreateFontCursor — create a cursor from the standard cursor font. 


Synopsis 
#include <X11/cursorfont.h> 
Cursor XCreateFontCursor (display, shape) 
Display *display; 
unsigned int shape; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
shape Specifies which character in the standard cursor font should be used for the cur- 
sor. 
Description 


X provides a set of standard cursor shapes in a special font named “cursor.” Programs are 
encouraged to use this interface for their cursors, since the font can be customized for the indi- 
vidual display type and shared between clients. 


The hotspot comes from the information stored in the font. The initial colors of the cursor are 
black for the foreground and white for the background. XRecolorCursor can be 
used to change the colors of the cursor to those desired. 


For more information about cursors and their shapes in fonts, see Appendix I, The Cursor Font. 
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XCreateFontCursor (continued) Xlib — Cursors 


Errors 
BadAlloc 


BadFont 
BadValue The shape argument does not specify a character in the standard cursor font. 
Related Commands 


XCreateGlyphCursor, XCreatePixmapCursor, XDefineCursor, XFreeCursor, 
XQueryBestCursor, XQueryBestSize, XRecolorCursor, XUndefineCursor. 
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Name 


XCreateGC — create a new graphics context for 4 given screen with the depth of the specified 


Synopsis 


drawable. 


GC XCreateGC (display, drawable, valuemask, values) 
Display *display; 
Drawable drawable; 
unsigned long valuemask; 
XGCValues *values; 


Arguments 


display 


drawable 


valuemask 


values 


Description 


Specifies a connection to an X server; returned from XOpenDisplay. 


Specifies a drawable. The created GC can only be used to draw in drawables 
of the same depth as this drawable. 


Specifies which members of the GC are to be set using information in the 
values structure. valuemask is made by combining any number of the 
mask symbols listed in the Structures section. 


Specifies a pointer to an XGCValues structure which will provide compo- 
nents for the new GC. 


XCreateGC creates a new graphics context resource in the server. The returned GC can be 
used in subsequent drawing requests, but only on drawables on the same screen and of the same 
depth as the drawable specified in the drawable argument. 


The specified components of the new graphics context in valuemask are set to the values 
passed in the values argument. Unset components default as follows: 


Component 





plane mask 
foreground 
background 
line width 
Pines byte 
cap style 
join style 
fens ty ue 
eee 
arc mode 
tile 
stipple 


LineSolid 

CapButt 

JoinMiter 

FillSolid 

EvenOddRule 

ArcPieSlice 

Pixmap filled with foreground pixel 
Pixmap filled with 1’s 
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XCreateGC 


Errors 

BadAlloc Server could not allocate memory for GC. 

BadDrawable Specified drawable is invalid. 

BadFont Font specified for font component of GC has not been loaded. 

BadMatch Pixmap specified for tile component has different depth or is on different 
screen from the specified drawable. Or pixmap specified for stipple or 
clip mask component has depth other than 1. 

BadPixmap Pixmap specified for tile, stipple, or clip mask components is inva- 
lid. 

BadValue Values specified for function, line style, cap_style, 
join_style, fill_style, fill_rule, subwindow_mode, graph- 
ics_exposures, dashes, or arc_mode are invalid, or invalid mask 
specified for val uemask argument. 

Structures 

typedef struct { 

nts Lune dons /* logical operation */ 
unsigned long plane _mask; /* plane mask */ 
unsigned long foreground; /* foreground pixel */ 
unsigned long background; /* background pixel */ 
int line width; /* line width */ 
int. Winew sity ley, /* LineSolid, LineOnOffDash, LineDoubleDash */ 
int cap style; /* CapNotLast, CapButt, CapRound, CapProjecting */ 
ite) Caney ley /* JoinMiter, JoinRound, JoinBevel */ 
ine £11 vstyle, /* FLlUSolid, FillTiled, /FillStippled */ 
Lit) seals eae /* EvenOddRule, WindingRule */ 
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Component 













ts x origin 
Eseysonrrgin 
font 


subwindow_mode 
graphics exposures 
aM axa Or- 4 ula 
CARN OM ago tad Galen 


clip mask 
dash_ offset 
dash_ list 





(continued) Xlib — Graphics Context 


(implementation dependent) 
ClipByChildren 
True 

0 

0 

None 

0 

4 (i.e., the list [4, 4]) 


An application should minimize the number of GCs it creates, because some servers cache a 
limited number of GCs in the display hardware, and can attain better performance with a small 


number of GCs. 


For more information, see Volume One, Chapter 5, The Graphics Context. 


Xlib —- Graphics Context (continued) XCreateGC 


int arc _mode; /* ArcPieSlice, ArcChord */ 

Pixmap tile; “Y* tile pixmap for tiling operations */ 
Pixmap stipple; /* stipple 1 plane pixmap for stipping */ 
Dt CsexP ort i ny /* offset for tile or stipple operations */ 
int ts_y origin; 

Font font; /* default text font for text operations */ 
int subwindow_mode; /* ClipByChildren, IncludeInferiors */ 

Bool graphics exposures; /* generate events on XCopyArea, XCopyPlane */ 
int clip x origing /* origin for clipping */ 

int clip _y origin; 

Pixmap clip mask; /* bitmap clipping; other calls for rects x] 
int dash_offset; /* patterned/dashed line information */ 


char dashes; 
} XGCValues; 


#define GCFunction (1L<<0) 
#define GCPlaneMask (1L<<1) 
#define GCForeground (1L<<2) 
#define GCBackground (1L<<3) 
#define GCLineWidth (1L<<4) 
#define GCLineStyle (1L<<5) 
#define GCCapStyle (1L<<6) 
#define GCJoinStyle (1L<<7) 
#define GCFillStyle (1L<<8) 
#define GCFillRule (1L<<9) 
#define GCTile (1L<<10) 
#define GCStipple (1b<<i1.) 
#define GCTileStipXOrigin (1L<<12) 
#define GCTileStipYOrigin (1L<<13) 
#define GCFont (1L<<14) 
#define GCSubwindowMode (1L<<15) 
#define GCGraphicsExposures (1L<<16) 
#define GCClipxXOrigin (1L<<17) 
#define GCClipYOrigin (1L<<18) 
#define GCClipMask (1L<<19) 
#define GCDashOffset (1L<<20) 
#define GCDashList (1L<<21) 
#define GCArcMode (Lh<<22) 


Related Commands 
DefaultGC, XChangeGC, XCopyGC, XFreeGC, XGContextFromGC, XGetGCValues, 
XSetArcMode, XSet Background, XSetClipMask, XSetClipOrigin, XSetClip- 
Rectangles, xSetDashes, XSetFillRule, XSetFillStyle, XSetForeground, 
XSetFunction, XSetGraphicsExposures, XSetLineAttributes, XSetPlane- 
Mask, XSetState, XSetStipple, XSet SubwindowMode, XSetTSOrigin. 
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XCreateGlyphCursor Yun cso 


Name 
XCreateGlyphCursor — create a cursor from font glyphs. 


Synopsis 
Cursor XCreateGlyphCursor (display, source_font, mask_font, 

source char, mask_char, foreground_color, back- 
ground_color) 

Display *display; 

Font source_font, mask_font; 

unsigned int source_char, mask_char; 

XColor *foreground_color; 

XColor *background_color; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 


source font Specifies the font from which a character is to be used for the cursor. 
mask_font Specifies the mask font. Optional; specify 0 if not needed. 
source_char Specifies the index into the cursor shape font. 


mask_char Specifies the index into the mask shape font. Optional; specify O if not 
needed. 


foreground_color 
Specifies the red, green, and blue (RGB) values for the foreground. 


background_color 
Specifies the red, green, and blue (RGB) values for the background. 


Description 
XCreateGlyphCursor is similar to XCreatePixmapCursor, but the source and mask 
bitmaps are obtained from separate font characters, perhaps in separate fonts. The mask font 
and character are optional. If mask_char is not specified, all pixels of the source are 
displayed. 


The x offset for the hotspot of the created cursor is the left-bearing for the source character, and 
the y offset is the ascent, each measured from the upper-left corner of the bounding rectangle of 
the character. 


The origins of the source and mask (if it is defined) characters are positioned coincidently and 
define the hotspot. The source and mask need not have the same bounding box metrics, and 
there is no restriction on the placement of the hotspot relative to the bounding boxes. 


Note that source_char and mask_char are of type unsigned int, not of type 
XChar2b. For two-byte matrix fonts, source_char and mask_char should be formed 
with the byte1 member in the most significant byte and the byt e2 member in the least signif- 
icant byte. 
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Xlib —- Cursors (continued) XCreateGlyphCursor 


You can free the fonts with XFreeFont if they are no longer needed after creating the glyph 
cursor. 


For more information on fonts and cursors, see Volume One, Chapter 6, Drawing Graphics and 
Text. 


Structures 
typedef struct { 
unsigned long pixel; 
unsigned short red, green, blue; 
char flags; Fe /* DoRed, DoGreen, DoBlue */ 
char pad; 
} XColor; 


Errors 
BadAlloc 
BadFont 
BadValue source_charnot defined in source_font. 


mask_char not defined in mask_font (if mask_font defined). 


Related Commands 
XCreateFontCursor, XCreatePixmapCursor, XDefineCursor, XFreeCursor, 
XQueryBestCursor, XQueryBestSize, XRecolorCursor, XUndefineCursor. 
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Name 


XCreateImage — allocate memory for an XImage structure. 


Synopsis 


#include <X11/Xutil.h> 
XImage *XCreateImage (display, visual, depth, format, offset, 
data, width, height, bitmap_pad, bytes_per_line) 
Display *display; 
Visual *visual; 
unsigned int depth; 
int format; 
int offset; 
char *data; 
unsigned int width; 
unsigned int height; 
int bitmap_pad; 
int bytes_per_line; 


Arguments 
display 


visual 


depth 


format 


offset 


data 


width 
height 


bitmap_pad 


Specifies a connection to an X server; returned from XOpenDisplay. 


Specifies a pointer to a visual that should match the visual of the window the 
image is to be displayed in. 


Specifies the depth of the image. 


Specifies the format for the image. Pass one of these constants: XYPixmap, 
or ZPixmap. 


Specifies the number of pixels beyond the beginning of the data (pointed to 
by data) where the image actually begins. This is useful if the image is not 
aligned on an even addressable boundary. 


Specifies a pointer to the image data. 
Specify the width and height in pixels of the image. 


Specifies the quantum of a scan line. In other words, the start of one scan line 
is separated in client memory from the start of the next scan line by an integer 
multiple of this many bits. You must pass one of these values: 8,16, or 32. 


bytes_per line 
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Specifies the number of bytes in the client image between the start of one 
scan line and the start of the next. If you pass a value of 0 here, Xlib assumes 
that the scan lines are contiguous in memory and thus calculates the value of 
bytes per line itself. 
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Description 
XCreateImage allocates the memory needed for an XImage structure for the specified dis- 
play and visual. 


This function does not allocate space for the image itself. It initializes the structure with byte 
order, bit order, and bitmap unit values, and returns a pointer to the XImage structure. The red, 
green, and blue mask values are defined for ZPixmap format images only and are derived from 
the Visual structure passed in. 


For a description of images, see Volume One, Chapter 6, Drawing Graphics and Text. 


Related Commands 
ImageByteOrder, XAddPixel, XDestroyImage, XGet Image, XGet Pixel, XGet- 
SubImage, XPutImage, XPutPixel, XSubImage. 
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XCreatePixmap Xlib — Pixmaps and Tiles— 


Name 
XCreatePixmap — create a pixmap. 
Synopsis 
Pixmap XCreatePixmap (display, drawable, width, height, depth) 
Display *display; 
Drawable drawable; 
unsigned int width, height; 
unsigned int depth; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 


drawable Specifies the drawable. May be an Input Only window. 


width Specify the width and height in pixels of the pixmap. The values must be 
height nonzero. : 
depth Specifies the depth of the pixmap. The depth must be supported by the screen 


of the specified drawable. (Use XListDepths if in doubt.) 


Description 
XCreatePixmap creates a pixmap resource and returns its pixmap ID. The initial contents 
of the pixmap are undefined. 


The server uses the drawable argument to determine which screen the pixmap is stored on. 
The pixmap can only be used on this screen. The pixmap can only be drawn drawn into with 
GCs of the same depth, and can only be copied to drawables of the same depth, except in 
XCopyPlane. 


A bitmap is a single-plane pixmap. There is no separate bitmap type in X Version 11. 


Pixmaps should be considered a precious resource, since many servers have limits on the 
amount of off-screen memory available. 


For more information, see Volume One, Chapter 6, Drawing Graphics and Text. 


Errors 
BadAlloc 


BadDrawable 


BadValue width or height is 0. 
depth is not supported on screen. 


Related Commands 
XCreateBitmapFromData, XCreatePixmapFromBitmapData, XFreePixmap, 
XListDepths, XListPixmapFormat, XQueryBestCursor, XQueryBestSize, 
XQueryBestStipple, XQueryBestTile, XReadBitmapFile, XSetTile, xSet- 
WindowBackgroundPixmap, XSetWindowBorderPixmap, XWriteBitmapFile. 
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Name 
XCreatePixmapCursor — create a cursor from two bitmaps. 


Synopsis 
Cursor XCreatePixmapCursor (display, source, mask, 
foreground_color, background_color, x_hot, y_hot) 
Display *display; 
Pixmap source; 
Pixmap mask; 
XColor *foreground_color; 
XColor *background_color; 
unsigned int x_hot, y hot; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
source Specifies the shape of the source cursor. A pixmap of depth 1. 
mask Specifies the bits of the cursor that are to be displayed (the mask or stipple). 


A pixmap of depth 1. 


foreground_color 
Specifies the red, green, and blue (RGB) values for the foreground. 


background_color 
Specifies the red, green, and blue (RGB) values for the background. 


x_hot Specify the coordinates of the cursor’s hotspot relative to the source’s origin. 
y_hot Must be a point within the source. 
_ Description 


%CreatePizxmapCursor creates a cursor and returns a cursor ID. Foreground and back- 
ground RGB values must be specified using foreground_color and back- 
ground_color, even if the server only has a monochrome screen. The fore- 
ground_color is used for the 1 bits in the source, and the background is used for the 0 bits. 
Both source and mask (if specified) must have depth 1, but can have any root. The mask pix- 
map defines the shape of the cursor; that is, the 1 bits in the mask define which source pixels 
will be displayed. If no mask is given, all pixels of the source are displayed. The mask, if 
present, must be the same size as the source. 


The pixmaps can be freed immediately if no further explicit references to them are to be made. 
For more information on cursors, see Volume One, Chapter 6, Drawing Graphics and Text. 
Structures 
typedef struct { 
unsigned long pixel; 
unsigned short red, green, blue; 
char flags; /* DoRed, DoGreen, DoBlue */ 
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XCreatePixmapCursor (continued) Xlib — Pixmaps and Tiles 


char pad; 
} XColor; 


Errors 
BadAlloc 


BadMatch Mask bitmap must be the same size as source bitmap. 
BadPixmap 
Related Commands 
XCreateBitmapFromData, XDefineCursor, XCreateFontCursor, XCreate- 
Pixmap, XCreatePixmapCursor, XFreeCursor, XFreePixmap, XQueryBest- 


Cursor, XQueryBestCursor, XQueryBestSize, XQueryBestSize, XRead- 
BitmapFile, XRecolorCursor, XUndefineCursor. 
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Name 
XCreatePixmapFromBitmapData — créate a pixmap with depth from bitmap data. 


Synopsis 
Pixmap XCreatePixmapFromBitmapData (display, drawable, data, 
width, height, fg, bg, depth) 
Display *display; 
Drawable drawable; 
char *data; 
unsigned int width, height; 
unsigned long fg, bg; 
unsigned int depth; 


Arguments 
display Specifies a connection to an Display structure, returned from XOpen- 
Display. 
drawable Specifies a drawable ID which indicates which screen the pixmap is to be 
used on. 
data Specifies the data in bitmap format. 
width Specify the width and height in pixels of the pixmap to create. 
height 
fg Specify the foreground and background pixel values to use. 
bg 
depth Specifies the depth of the pixmap. Must be valid on the screen specified by 
drawable. 
Description 


XCreatePixmapFromBitmapData creates a pixmap of the given depth using bitmap data 
and foreground and background pixel values. 


The following format for the data is assigned, where the variables are members of the XImage 
structure described in Volume One, Chapter 6, Drawing Graphics and Text: 


format=XYPixmap 

bit _order=LSBFirst 

byte order=LSBFirst 
bitmap_unit=8 

bitmap _pad=8 

xoffset=0 

no extra bytes per line 


XCreatePixmapFromBitmapData Creates an image from the data and uses XPut Image 
to place the data into the pixmap. For example: 
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XCreatePixmapFromBitmapData (continued) Xlib — Pixmaps and Bitmaps 


#define gray width 16 

#define gray height 16 

#define gray x hot 8 

#define gray _y hot 8 

Seduce charm qray bi.es [| af 
Oxto pO Oxes, OxXCi UxXCi, OX tore O ole per O meno yea sco liry 
Oxtd, 902337 -0xec,O0x7t, Oxte, Oxi. Oxter Oxie,” Ox7e, 
Oxi, Oxte, 0x37, Oxec, Oxbb, Oxdd,0x9e, ~Oxee7 Oxcw 
Opes), OSS sey, Obaesl, (Oscloe)e 

unsigned long foreground, background; 

unsigned int depth; 


/* open display, determine colors and depth */ 


Pixmap XCreatePixmapFromBitmapData(display, window, gray bits, 
gray _width, gray height, foreground, background, depth); 


If you want to use data of a different format, it is straightforward to write a routine that does 
this yourself, using images. 


Pixmaps should be considered a precious resource, since many servers have limits on the 
amount of off-screen memory available. 


Errors 
BadAlloc 
BadDrawable 


BadValue The width or height of pixmap are zero, or depth is not a valid depth on 
the screen specified by drawable. 


Related Commands 
XCreateBitmapFromData, XCreateFontCursor, XCreatePixmap, XCreate- 
PixmapCursor, XDefineCursor, XFreeCursor, XFreePixmap, XListPixmap- 
Formats, XQueryBestCursor, XQueryBest Size, XReadBitmapFile, XRecolor- 
Cursor, XUndefineCursor. 
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Name 
XCreateRegion — create a new empty region. 


‘ 


Synopsis 
Region XCreateRegion () 


Description 
XCreateRegion creates a new region of undefined size. XPolygonRegion can be used to 


create a region with a defined shape and size. Many of the functions that perform operations on 
regions can also create regions. . 


For a description of regions, see Volume One, Chapter 6, Drawing Graphics and Text. 


Structures 
Region is a pointer to an opaque structure type. 


Related Commands 
XClipBox, XDestroyRegion, XEmptyRegion, XEqualRegion, XIntersect- 
Region, XOffsetRegion, XPointInRegion, XPolygonRegion, XRectInRegion, 
XSetRegion, XShrinkRegion, XSubtractRegion, XUnionRectWithRegion, 
XUnionRegion, XXorRegion. 
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Name 
XCreateSimpleWindow — create an unmapped InputOutput window. 


Synopsis 
Window XCreateSimpleWindow(display, parent, x, y, width, height, 
border width, border, background) 
Display *display; 
Window parent; 
Slits sos VS 
unsigned int width, height, border_width; 
unsigned long border; 
unsigned long background; 


Arguments 
display Specifies a pointer to the Di splay structure; returned from XOpenDisplay. 
parent Specifies the parent window ID. Must be an Input Output window. 
x Specify the x and y coordinates of the upper-left pixel of the new window’s 
y border relative to the origin of the parent (inside the parent window’s border). 
width Specify the width and height, in pixels, of the new window. These are the 
height inside dimensions, not including the new window’s borders, which are entirely 


outside of the window. Must be nonzero. Any part of the window that extends 
outside its parent window is clipped. 


border width 
Specifies the width, in pixels, of the new window’s border. 


border Specifies the pixel value for the border of the window. 


background Specifies the pixel value for the background of the window. 


Description 
XCreateSimpleWindow creates an unmapped InputOutput subwindow of the specified 
parent window. Use XCreateWindow if you want to set the window attributes while creating 
a window. (After creation, XChangeWindowAttributes can be used.) 


XCreateSimpleWindow returns the ID of the created window. The new window is placed 
on top of the stacking order relative to its siblings. Note that the window is unmapped when it 
is created —use MapWindow to display it. This function generates a XCreateNotify event. 


The initial conditions of the window are as follows: 


The window inherits its depth, class, and visual from its parent. All other window attributes 
have their default values. 


All properties have undefined values. 


The new window will not have a cursor defined; the cursor will be that of the window’s parent 
until the cursor attribute is set with XDefineCursor or XChangeWindowAttributes. 
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If no background or border is specified, CopyFromParent is implied. 
For more information, see Volume One, Chapter‘ 2, X Concepts, and Volume One, Chapter 3, 
Basic Window Program. 
Errors 
BadAlloc 
BadMatch 
BadValue width or height is zero. 
BadWindow Specified parent is an InputOnly window. 


Related Commands 
XCreateWindow, XDest roySubwindows, XDest royWindow. 
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Name 


XCreateWindow — create a window and set attributes. 


Synopsis 


Window XCreateWindow (display, parent, x, y, width, height, 
border width, depth, class, visual, valuemask, 
attributes) 

Display *display; 

Window parent; 

LAE ax Vs 
unsigned int width, height; 
unsigned int border_width; 

int depth; 

unsigned int class; 

Visual *visual 

unsigned long valuemask; 
XSetWindowAttributes *attributes; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
parent Specifies the parent window. Parent must be Input Output if class of win- 
dow created is to be InputOutput. 
ce Specify the x and y coordinates of the upper-left pixel of the new window’s 
y border relative to the origin of the parent (upper left inside the parent’s border). 
width Specify the width and height, in pixels, of the window. These are the new win- 
height dow’s inside dimensions. These dimensions do not include the new window’s 
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borders, which are entirely outside of the window. Must be nonzero, otherwise 
the server generates a BadValue error. 


border width 
Specifies the width, in pixels, of the new window’s border. Must be 0 for 
InputOn1ly windows, otherwise a BadMat ch error is generated. 


depth Specifies the depth of the window, which is less than or equal to the parent’s 
depth. A depth of CopyFromParent means the depth is taken from the par- 
ent. Use XListDepths is choosing an unusual depth. The specified depth 
paired with the visual argument must be supported on the screen. 


class Specifies the new window’s class. Pass one of these constants: Input- 
Output, InputOnly, or CopyFromParent. 


visual Specifies a connection to an visual structure describing the style of colormap to 
be used with this window. CopyFromParent is valid. 


valuemask Specifies which window attributes are defined in the attributes argument. 
If valuemask is 0, attributes is not referenced. This mask is the bitwise 
OR of the valid attribute mask bits listed in the Structures section below. 
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attributes Attributes of the window to be set at creation time should be set in this struc- 
ture. The valuemask should:have the appropriate bits set to indicate which 
attributes have been set in the structure. 


Description 
To create an unmapped subwindow for a specified parent window use XCreateWindow or 
XCreateSimpleWindow. XCreateWindow is a more general function that allows you to 
set specific window attributes when you create the window. If you do not want to set specific 
attributes when you create a window, use XCreateSimpleWindow, which creates a window 
that inherits its attributes from its parent...xCreateSimpleWindow creates only Input- 
Output windows that use the default depth and visual. 


XCreateWindow returns the ID of the created window. xCreateWindow causes the X 
server to generate a CreateNotify event. The newly created window is placed on top of its 
siblings in the stacking order. 


Extension packages may define other classes of windows. 


The visual should be DefaultVisual or one returned by XGet VisualInfo or XMatch- 
VisualInfo. The depth should be DefaultDepth, 1, or a depth returned by XList- 
Depths. In current implementations of Xlib, if you specify a visual other than the one used by 
the parent, you must first find (using XGet RGBColormaps) or create a colormap matching 
this visual and then set the colormap window attribute in the attributes and valuemask 
arguments. Otherwise, you will get a BadMatch error. 


For more information, see Volume One, Chapter 4, Window Attributes. 


Structures 
/* 
* Data structure for setting window attributes. 
xi, 
typedef struct { 
Pixmap background_pixmap; /* background or None or ParentRelative */ 
unsigned long background pixel; /* background pixel */ 
Pixmap border pixmap; /* border of the window */ 
unsigned long border pixel; /* border pixel value */ 
int bit gravity; /* one of bit gravity values */ 
int win_gravity; /* one of the window gravity values */ 
int backing_store; /* NotUseful, WhenMapped, Always */ 
unsigned long backing planes; /* planes to be preseved if possible */ 
unsigned long backing pixel; /* value to use in restoring planes */ 
Bool save_under; /* should bits under be saved (popups) */ 
long event_mask; /* set of events that should be saved */ 
long do_not_ propagate mask; /* set of events that should not propagate */ 
Bool override redirect; /* boolean value for override-redirect */ 
Colormap colormap; /* colormap to be associated with window */ 
Cursor cursor? /* cursor to be displayed (or None) */ 


} XSetWindowAttributes; 
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/* Definitions for valuemask argument */ 


#define CWBackPixmap (1L<<0) 

#define CWBackPixel (TL<<t) 

#define CWBorderPixmap (1L<<2) 

#define CWBorderPixel (1L<<3) 

#define CWBitGravity (1L<<4) 

#define CWWinGravity (1L<<5) 

#define CWBackingStore (1L<<6) 

#define CWBackingPlanes (1L<<7) 

#define CWBackingPixel (1L<<8) 

#define CWOverrideRedirect (1L<<9) 

#define CWSaveUnder (1L<<10) 

#define CWEventMask (1L<<14)) 

#define CWDontPropagate (1L<<12) 

#define CWColormap (1E<<13)) 

#define CWCursor (1L<<14) 

Errors 

BadAlloc Attribute besides win_gravity, event_mask, do_not_propagate_ 
mask, override redirect or cursor specified for InputOnly win- 
dow. 


BadColormap depth nonzero for InputOnly. 

BadCursor Parent of InputOutput is InputOnly. 
BadMatch border width is nonzero for InputOnly. 
BadPixmap depth not supported on screen for Input Output. 
BadValue widthor height is 0. 


BadWindow visual not supported on screen. 


Related Commands 
XCreateSimpleWindow, XDest roySubwindows, XDest royWindow, XList- 
Depths. 
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Name 
XDefineCursor — assign a cursor to a window. 


Synopsis 
XDefineCursor (display, w, cursor) 
Display *display; 
Window w; 
Cursor, curson; 


Arguments : 
display Specifies a connection to an X server; returned from XOpenDisplay. 
w Specifies the ID of the window in which the cursor is to be displayed. 
cursor Specifies the cursor to be displayed when the pointer is in the specified win- 
dow. Pass None to have the parent’s cursor displayed in the window, or for 
the root window, to have the default cursor displayed. 
Description 


Sets the cursor attribute of a window, so that the specified cursor is shown whenever this win- 
dow is visible and the pointer is inside. If XDefineCursor is not called, the parent’s cursor 
is used by default. 


For more information on available cursors, see Appendix I, The Cursor Font. 


Errors 
BadCursor 
BadWindow 


Related Commands 
XCreateFontCursor, XCreateGlyphCursor, XCreatePixmapCursor, XFree- 
Cursor, XQueryBestCursor, XQueryBestSize, XRecolorCursor, XUndefine- 
Cursor. 
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Name 
XDeleteAssoc — delete an entry from an association table. 


Synopsis 
XDeleteAssoc (display, table, x_id) 
Display *display; 
XAssocTable *table; 


SLDe yids 
Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
table Specifies one of the association tables created by XCreateAssocTable. 
x 1d Specifies the X resource ID of the association to be deleted. 
Description : 


This function is provided for compatibility with X Version 10. To use it you must include the 
file <X11/X10.h> and link with the library -loldXx. 


XDeleteAssoc deletes an association in an XAssocTable keyed on its XID. Redundant 
deletes (and deletes of nonexistent XID’s) are meaningless and cause no problems. Deleting 
associations in no way impairs the performance of an XAssocTable. 


For more information on association tables, see Volume One, Appendix B, X10 Compatibility. 


Structures 
typedef struct { 
XAssoc *buckets; {x -pointer to first bucket im array) */ 
Pte sizes /* table size (number of buckets) */ 


} XAssocTable; 


Related Commands 
XCreateAssocTable, XDestroyAssocTable, XLookUpAssoc, XMakeAssoc. 
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Name 
XDeleteContext — delete a context entry for a given window and type. 


Synopsis 
int XDeleteContext (display, w, context) 
Display *display; 
Window w; 
XContext context; 


Arguments es 
display Specifies a connection to an X server; returned from XOpenDisplay. 
Ww Specifies the window with which the data is associated. 
context Specifies the context type to which the data belongs. 

Description 


XDeleteContext deletes the entry for the given window and type from the context data 
structure defined in <X/1/Xutil.h>. This function returns XCNOENT if the context could not be 
found, or zero if it succeeds. XDeleteContext does not free the memory allocated for the 
data whose address was saved. 


See Volume One, Chapter 13, Other Programming Techniques, for a description of context 
management. 


Structures 
typedef int XContext; 


Related Commands 
XFindContext, XSaveContext, XUniqueContext. 
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Name 
XDeleteModifiermapEntry — delete an entry from an XModifierKeymap structure. 


Synopsis 
XModifierKeymap *XDeleteModifiermapEntry (modmap, 
keysym_entry, modifier) 
XModifierKeymap *modmap; 
KeyCode keysym_entry; 
int modifier; 


Arguments 
modmap Specifies a pointer to an XModifierKeymap Structure. 


keysym_entry 
Specifies the keycode of the key to be deleted from modmap. 


modifier Specifies the modifier you no longer want mapped to the keycode specified in 
keysym_entry. This should be one of the constants: ShiftMapIndex, 
LockMapIndex, ControlMapIndex, ModlMapIndex, Mod2Map- 
Index, Mod3MapIndex, Mod4MapIndex, or Mod5MapIndex. 


Description 
XDeleteModifiermapEntry returns an XModifierKeymap Structure suitable for cal- 
ling XSetModifierMapping, in which the specified keycode is deleted from the set of key- 
codes that is mapped to the specified modifier (like Shift or Control). xDelete- 
ModifiermapEnt ry itself does not change the mapping. 


This function is normally used by calling xXGetModifierMapping to get a pointer to the 
current XModifierKeymap structure for use as the modmap argument to XDelete- 
ModifiermapEntry. 


Note that the structure pointed to by modmap is freed by XDeleteModifiermapEntry. It 
should not be freed or otherwise used by applications after this call. 


For a description of the modifier map, see XSetModifierMapping. 


Structures 
typedef struct { 
int max_keypermod; /* server's max number of keys per modifier */ 
KeyCode *modifiermap; /* an 8 by max_keypermod array of 
* keycodes to be used as modifiers */ 
} XModifierKeymap; 


#define ShiftMapIndex 
#define LockMapIndex 
#define ControlMapIndex 
#define ModlMapIndex 
#define Mod2MapIndex 
#define Mod3MapIndex 


OP WNFr O 
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#define Mod4MapIndex 6 
#define Mod5MapIndex i 


Related Commands 
XF reeModifiermap, XGetKeyboardMapping, XGetModifierMapping, 
XKeycodeToKeysym, XKeysymToKeycode, XKeysymToSt ring, XLookupKeysym, 
XLookupSt ring, XNewModifiermap, XQueryKeymap, XRebindKeySym, 
XRefreshKeyboardMapping, XSetModifierMapping, XStringToKeysym, 
InsertModifiermapEntry. 
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Name 
XDeleteProperty — delete a window property. 


Synopsis 
XDeleteProperty (display, w, property) 
Display *display; 
Window w; 
Atom property; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
Ww Specifies the ID of the window whose property you want to delete. 


property Specifies the atom of the property to be deleted. 


Description 
XDeleteProperty deletes a window property, so that it no longer contains any data. Its 
atom, specified by property, still exists after the call so that it can be used again later by any 
application to set the property once again. If the property was defined on the specified window, 
XDeleteProperty generates a PropertyNotify event. 


See the introduction to properties in Volume One, Chapter 2, X Concepts, or more detailed 
information in Volume One, Chapter 10, Interclient Communication. 


Errors 
BadAtom 
BadWindow 


Related Commands 
XChangeProperty, XGetAtomName, XGetFontProperty, XGetWindowProperty, 
XInternAtom, XListProperties, XRotateWindowProperties, XSetStandard- 
Properties. 
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Name 
XDestroyAssocTable — free the memory allocated for an association table. 


Synopsis 
XDestroyAssocTable (table) 
XAssocTable *table; 


Arguments 
table Specifies the association table whose memory is to be freed. 


Description 
This function is provided for compatibility with X Version 10. To use it you must include the 
file <X11/X10.h> and link with the library -loldXx. 


Using an XAssocTab1e after it has been destroyed will have unpredictable consequences. 


For more information on association tables, see Volume One, Appendix B, X/0 Compatibility. 


Structures 
typedef struct { 
XAssoc *buckets; /* pointer to first bucket in array */ 
Dink size /* table size (number of buckets) */ 


} XAssocTable; 


Related Commands 
XCreateAssocTable, XDeleteAssoc, XLOokUpASssoc, XMakeAssoc. 
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Name 
XDestroyImage — deallocate memory associated with an image. 


Synopsis 
int XDestroyImage (ximage) 
XImage *ximage; 


Arguments 
ximage Specifies a pointer to the image. 


Description 
XDest royImage deallocates the memory associated with an XImage structure. This mem- 
ory includes both the memory holding the XImage structure, and the memory holding the 
actual image data. (If the image data is statically allocated, the pointer to the data in the 
XImage structure must be set to zero before calling XDest royImage.) 


For more information on images, see Volume One, Chapter 6, Drawing Graphics and Text. 


Related Commands 
ImageByteOrder, XAddPixel, XCreateImage, XGet Image, XGet Pixel, XGet- 
SubImage, XPut Image, XPut Pixel, XSubImage. 
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Name 
XDestroyRegion — deallocate storage associated with a region. 


Synopsis 
XDestroyRegion (r) 
Region r; 


Arguments 
ig Specifies the region to be destroyed. 


Description 
XDestroyRegion frees the memory associated with a region and invalidates pointer r. 


See Volume One, Chapter 6, Drawing Graphics and Text, for a description of regions. 


Related Commands 
XClipBox, XCreateRegion, XEmptyRegion, XEqualRegion, XIntersect- 
Region, XOffsetRegion, XPointInRegion, XPolygonRegion, XRectInRegion, 
XSetRegion, XShrinkRegion, XSubt ractRegion, XUnionRectWithRegion, 
XUnionRegion, XXorRegion. 
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Name 
XDestroySubwindows — destroy all subwindows of a window. 


Synopsis 
XDestroySubwindows (display, w) 
Display *display; 
Window w; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
Ww Specifies the ID of the window whose subwindows are to be destroyed. 
Description 


This function destroys all descendants of the specified window (recursively), in bottom to top 
stacking order. 


XDest roySubwindows generates exposure events on window w, if any mapped subwindows 
were actually destroyed. This is much more efficient than deleting many subwindows one at a 
time, since much of the work need only be performed once for all of the windows rather than 
for each window. It also saves multiple exposure events on the windows about to be destroyed. 
The subwindows should never again be referenced. 


XCloseDisplay automatically destroys all windows that have been created by that client on 
the specified display (unless called after a fork system call). 


Never call XDest roySubwindows with the window argument set to the root window! This 
will destroy all the applications on the screen, and if there is only one screen, often the server 
as well. 


Errors 
BadWindow 


Related Commands 
XCreateSimpleWindow, XCreateWindow, XDest royWindow. 
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Name ; 
XDestroy Window — unmap and destroy a window and all subwindows. 
Synopsis 
XDestroyWindow (display, window) 
Display *display; 
Window window; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
window Specifies the ID of the window to be destroyed. 

Description 


If window is mapped, an UnmapWindow request is performed automatically. The window 
and all inferiors (recursively) are then destroyed, and a Dest royNotify event is generated 
for each window. The ordering of the Dest royNot ify events is such that for any given win- 
dow, DestroyNotify is generated on all inferiors of the window before being generated on 
the window itself. The ordering among siblings and across subhierarchies is not otherwise con- 
strained. 


The windows should never again be referenced. 


Destroying a mapped window will generate exposure events on other windows that were 
obscured by the windows being destroyed. XDest royWindow may also generate Enter- 
Notify events if window was mapped and contained the pointer. 


No windows are destroyed if you try to destroy the root window. 


Errors 
BadWindow 


Related Commands 
XCreateSimpleWindow, XCreateWindow, XDestroySubwindows. 
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Name 
XDisableAccessControl — allow access from any host. 
Synopsis 
XDisableAccessControl (display) 
Display *display; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 


Description 
XDisableAccessControl instructs the server to allow access from clients on any host. 
This disables use of the host access list. 


This routine can only be called from a client running on the same host as the server. 
For more information on access control, see Volume One, Chapter 13, Other Programming 
Techniques. 


Errors 
BadAccess 


Related Commands 
XAddHost, XAddHosts, XEnableAccessControl, XListHosts, XRemoveHost, 
XRemoveHosts, XSetAccessControl. 
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Name 3 
XDisplayKeycodes — obtain the range of legal keycodes for a server. 


Synopsis 
XDisplayKeycodes (display, min_keycodes, max_keycodes) 
Display *display; 
int *min_keycode, *max_keycode; /* RETURN */ 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
min_keycode Returns the minimum keycode. 
max_keycode Returns the maximum keycode. 

Description 
XDisplayKeycodes returns the min_keycode and max_keycode supported by the 
specified server. The minimum keycode returned is never less than 8, and the maximum key- 


code returned is never greater than 255. Not all keycodes in this range are required to have cor- 
responding keys. 


For more information, see Volume One, Chapter 9, The Keyboard and Pointer. 


Related Commands 
XKeycodeToKeysym, XKeysymToKeycode, XLookupString. 
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XDisplayName Xlib — Error Handling — 


Name 
XDisplayName — report the display name (when connection to a display fails). 


Synopsis 
char *XDisplayName (string) 
char *string; 


Arguments 
string Specifies the character string. 


Description 
XDisplayName is normally used to report the name of the display the program attempted to 
open with XOpenDisplay. This is necessary because X error handling begins only after the 
connection to the server succeeds. If a NULL string is specified, XDisplayName looks in the 
DISPLAY environment variable and returns the display name that the user was requesting. 
Otherwise, XDisplayName returns its own argument. This makes it easier to report to the 
user precisely which server the program attempted to connect to. 


For more information, see Volume One, Chapter 3, Basic Window Program. 
Related Commands 


XGetErrorDatabaseText, XGetErrorText, XSetAfterFunction, XSetError- 
Handler, XSet10ErrorHandler, XSynchronize. 


140 Xlib Reference Manual 
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— Xlib — Drawing Primitives 


Name , 
XDraw — draw a polyline or curve between vertex list (from X10). 


Synopsis 
Status XDraw(display, drawable, gc, vlist, vcount) 
Display *display; 
Drawable drawable; 
CGCrge? 
Vertex *vlist; 
int veount; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 


drawable Specifies the drawable. 


gc Specifies the graphics context. 
vlist Specifies a pointer to the list of vertices that indicates what to draw. 
vcount Specifies how many vertices are in vlist. 

Description 


This function is provided for compatibility with X Version 10. To use it you must include the 
file <X11/X10.h> and link with the library -loldX. Its performance is likely to be low. 


XDraw draws an arbitrary polygon or curve. The figure drawn is defined by the specified list of 
vertices (vlist). The points are connected by lines as specified in the flags each the Vertex 
structure. 


The Vertex structure contains an x,y coordinate and a bitmask called flags that specifies 
the drawing parameters. 


The x and y elements of Vertex are the coordinates of the vertex that are relative to either the 
previous vertex (if VertexRelative is 1) or the upper-left inside corner of the drawable (if 
VertexRelative is 0). If VertexRelative is 0 the coordinates are said to be absolute. 
The first vertex must be an absolute vertex. 


If the VertexDontDraw bit is 1, no line or curve is drawn from the previous vertex to this 
one. This is analogous to picking up the pen and moving to another place before drawing 
another line. 


If the VertexCurved bit is 1, a spline algorithm is used to draw a smooth curve from the pre- 
vious vertex, through this one, to the next vertex. Otherwise, a straight line is drawn from the 
previous vertex to this one. It makes sense to set VertexCurved to 1 only if a previous and 
next vertex are both defined (either explicitly in the array, or through the definition of a closed 
curve —see below.) 


It is permissible for VertexDontDraw bits and VertexCurved bits to both be 1. This is 
useful if you want to define the previous point for the smooth curve, but you do not want an 
actual curve drawing to start until this point. 
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If VertexStartClosed bit is 1, then this point marks the beginning of a closed curve. This 
vertex must be followed later in the array by another vertex whose absolute coordinates are 
identical and which has VertexEndClosed bit of 1. The points in between form a cycle for 
the purpose of determining predecessor and successor vertices for the spline algorithm. 


XDraw achieves the effects of the X10 XDraw, XDrawDashed, and XDrawPatterned 
functions. 


XDraw uses the following graphics context components: function, plane_mask, 
line width, line style, cap_ style, join_style, fill_style, subwindow_ 
mode, clip_x origin, clip_y origin, and clip _mask. This function also uses 
these graphics context mode-dependent components: foreground, background, tile, 
stipple,ts_x origin,ts_y origin, dash_offset,and dash_list. 


A Status of zero is returned on failure, and nonzero on success. 
For more information, see Volume One, Appendix B, X10 Compatibility. 
Structures 
bypeder -stmuct ~ Vertex if 
Short x, yr 


unsigned short flags; 
} Vertex; 


/* defined constants for use as flags */ 


#define VertexRelative 0x0001 /* else absolute */ 
#define VertexDontDraw 0x0002 /* else draw */ 
#define VertexCurved 0x0004 /* else straight */ 
#define VertexStartClosed 0x0008 /* else not */ 
#define VertexEndClosed 0x0010 /* else not */ 


Related Commands 
XClearArea, XClearWindow, XCopyArea, XCopyPlane, XDrawArc, XDrawArcs, 
XDrawFilled, XDrawLine, XDrawLines, XDrawPoint, XDrawPoints, XDraw- 
Rectangle, XDrawRectangles, XDrawSegments, XFillArc, XFillArcs, XFill- 
Polygon, XFillRectangle, XFillRectangles. 


142 Xlib Reference Manual 
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Name : 
XDrawArc — draw an arc fitting inside a rectangle. ‘ 


Synopsis 
XDrawArc (display, drawable, gc, x, y, width, height, 

anglel, angle2) 

Display *display; 

Drawable drawable; 

GC gc; 

Take my 

unsigned int width, height; 

int anglel, angle2; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 


- drawable Specifies the drawable. 


gc Specifies the graphics context. 

x Specify the x and y coordinates of the upper-left corner of the rectangle that 

y contains the arc, relative to the origin of the specified drawable. 

width Specify the width and height in pixels of the major and minor axes of the arc. 

height 

anglel Specifies the start of the arc relative to the three-o’clock position from the 
center. Angles are specified in 64ths of a degree (360 * 64 is a complete 
circle), 

angle2 Specifies the end of the arc relative to the start of the arc. Angles are speci- 


fied in 64ths of a degree (360 * 64 is a complete circle). 


Description 

XDrawArc draws a circular or elliptical arc. An arc is specified by a rectangle and two angles. 
The x and y coordinates are relative to the origin of the drawable, and define the upper-left cor- 
ner of the rectangle. The center of the circle or ellipse is the center of the rectangle, and the 
major and minor axes are specified by the width and height, respectively. The angles are 
signed integers in 64ths of a degree, with positive values indicating counterclockwise motion 
and negative values indicating clockwise motion, truncated to a maximum of 360 degrees. The 
start of the arc is specified by angle1 relative to the three-o’clock position from the center, 
and the path and extent of the arc is specified by angle2 relative to the start of the arc. 


By specifying one axis to be zero, a horizontal or vertical line is drawn (inefficiently). 


Angles are computed based solely on the coordinate system and ignore the aspect ratio. In 
other words, if the bounding rectangle of the arc is not square and anglel is zero and 
angle2 is (45x64), a point drawn from the center of the bounding box through the endpoint 
of the arc will not pass through the corner of the rectangle. 


Xlib Reference Manual : 143 


XDrawArc (continued) Xlib — Drawing Primitives 


For any given arc, no pixel is drawn more than once, even if angle2 is greater than anglel 
by more than 360 degrees. 

XDrawArc uses these graphics context components; function, plane mask, 
line width, line style, cap_style, join_style, fill style, subwindow_ 
mode, clip x origin, clip_y origin, and clip mask. This function also uses 
these graphics context mode-dependent components: foreground, background, tile, 
stipple,ts_x origin,ts_y origin,dash_offset,anddash_list. 


For more information, see Volume One, Chapter 6, Drawing Graphics and Text. 


width 





12 o'clock 
(x,y) Angle = 90x64 
oN Angle = -—(270x64) 


Center of bounding 





. rectangle. 
eh 
“ 3 o'clock 
c 180x64 Angle = 0 
—-(180x64) 
6 o'clock 
Angle = 270x64=17280 
Angle = -— (90x64) =5760 
Example 1: Example 2: 
Arc from A1 to A2, Counterclockwise Arc from B1 to B2, Clockwise 
A1 = 90 X 64 B1 = 270 X 64 
A2 = 45 X 64 B2 = -(45 X 64) 


Errors 
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BadDrawable 
BadGC 
BadMatch 
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Related Commands ; 
XClearArea, XClearWindow, XCopyArea, XCopyPlane, XDraw, XDrawArcs, 
XDrawFilled, XDrawLine, XDrawLines, XDrawPoint, XDrawPoints, XDraw- 
Rectangle, XDrawRectangles, XDrawSegments, XFillArc, XFillArcs, XFill- 
Polygon, XFillRectangle, XFillRectangles. 
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Name 


XDrawArcs — draw multiple arcs. 


Synopsis 


XDrawArcs (display, drawable, gc, arcs, narcs) 


Display *display; 
Drawable drawable; 
GGagc, 

XATCl arcs; 

int narcs; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 


drawable Specifies the drawable. 


gc Specifies the graphics context. 
arcs Specifies a pointer to an array of arcs. 
narcs Specifies the number of arcs in the array. 
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12 o'clock 


(x,y) Angle = 90x64 
oN Angle = -(270x64) 


Center of bounding 





rectangle. 
S 
eS 9 o'clock 3 o'clock 
g Angle = 180x64 Angle = 0 
Angle = -(180x64) 
6 o'clock 
Angle = 270x64=17280 
Angle = -(90x64)=5760 
Example 1: Example 2: 
Arc from A1 to A2, Counterclockwise Arc from B1 to B2, Clockwise 
A1 =90 X 64 B1 = 270 X 64 
A2 = 45 X 64 B2 = -(45 X 64) 
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Description . 
This is the plural version of XDrawArc. See XDrawArc for details of drawing a single arc. 


There is a limit to the number of arcs that can be drawn in a single call. It varies according to 
the server. To determine how many arcs you can draw in a single call, find out your server’s 
maximum request size using XMaxRequestSize. Subtract 3 and divide by three: this is the 
maximum number of arcs you can draw in a single XDrawArcs Call. 


The arcs are drawn in the order listed in the arcs array. 


By specifying one axis to be zero, a horizontal or vertical line can be drawn. Angles are com- 
puted based solely on the coordinate system, ignoring the aspect ratio. 


For any given arc, no pixel is drawn more than once. If the last point in one arc coincides with 
the first point in the following arc, the two arcs will join correctly. If the first point in the first 
arc coincides with the last point in the last arc, the two arcs will join correctly. If two arcs join 
correctly and if line width is greater than 0 and the arcs intersect, no pixel is drawn more 
than once. Otherwise, the intersecting pixels of intersecting arcs are drawn multiple times. 
Specifying an arc with one endpoint and a clockwise extent draws the same pixels as specifying 
the other endpoint and an equivalent counterclockwise extent, except as it affects joins. 


XDrawArcs uses these graphics context components: function, plane_mask, 
line width, line style, cap_style, join_style, fill_style, subwindow_ 
mode, clip _x origin, clip _y origin, and clip _mask. This function also uses 
these graphics context mode-dependent components: foreground, background, tile, 
stipple,ts_x origin,ts_y origin, dash_offset,and dash_list. 


The following is a technical explanation of the points drawn by XDrawArcs. Foran arc speci- 
fied as [x, y, width, height, anglel, angle2], the origin of the major and minor axes is 
at [x+(width/2),y+(height/2) ], and the infinitely thin path describing the entire circle 
or ellipse intersects the horizontal axis at [x, y+(height/2)] and [x+width, 
yt+(height/2)] and intersects the vertical axis at [x+(width/2),y] and 
[x+(width/2), ytheight]. These coordinates can be fractional. That is, they are not 
truncated to discrete coordinates. The path should be defined by the ideal mathematical path. 
For a wide line with line width line width, the bounding outlines for filling are given by 
the infinitely thin paths describing the arcs: 


[x+dx/2, ytdy/2, width-dx, height-dy, anglel, angle2] 
and 


[x-line width/2, y-line width/2, width+line width, height+line width, 
anglel, angle2] 


where 


dx=min (line width, width) 
dy=min(line width, height) 
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If (height != width) the angles must be specified in the effectively skewed coordinate 
system of the ellipse (for a circle, the angles and coordinate systems are identical). The rela- 
tionship between these angles and angles expressed in the normal coordinate system of the 
screen (as measured with a protractor) is as follows: 


skewed-angle = atan(tan(normal-angle) * width/height) + adjust 


The skewed-angle and normal-angle are expressed in radians (rather than in 64ths of a degree) 
in the range [0,2*PI], and where atan returns a value in the range [-PI/2,P1I/2], and 
where adjust is: 


0 for normal-angle in the range [0,PI/2] 
PI for normal-angle in the range [PI/2, (3*PI)/2] 
2*PI for normal-angle in the range [(3*PI)/2,2*PT] 


For more information, see Volume One, Chapter 6, Drawing Graphics and Text. 


Structures 


typedef struct { 
SHOnmtEex; o> 
unsigned short width, height; 
short anglel, angle2; /* Start and end of arc, in */ 
/* 64ths of degrees */ 
} XArc; 


Errors 


BadDrawable 
BadGC 
BadMatch 


Related Commands 
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XClearArea, XClearWindow, XCopyArea, XCopyPlane, XDraw, XDrawArc, 
XDrawFilled, XDrawLine, XDrawLines, XDrawPoint, XDrawPoints, XDraw- 
Rectangle, XDrawRectangles, XDrawSegments, XFillArc, XFillArcs, XFill- 
Polygon, XFillRectangle, XFillRectangles. 
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Name 
XDrawFilled — draw a filled polygon or curve from vertex list (from X10). 


Synopsis 
Status XDrawFilled(display, drawable, gc, vlist, vcount) 
Display *display; 
Drawable drawable; 
GCrgc; 
Vertex *vlist; 
inteavcount.: 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 


drawable Specifies the drawable. 


gc Specifies the graphics context. 

wiLSt. - ~ Specifies a pointer to the list of vertices. 

vcount Specifies how many vertices are in vlist. 
Description 


This function is provided for compatibility with X Version 10. To use it you must include the 
file <XJ1/X10.h> and link with the library -loldX. XDrawFilled achieves the effects of the 
X Version 10 XDrawTiled and XDrawFilled functions. 


XDrawFilled draws arbitrary polygons or curves, according to the same rules as XDraw, and 
then fills them. 


XDrawFilled uses the following graphics context components: function, plane_mask, 
line_width, line style, cap_ style, join_style, fill style, 
subwindow_mode, clip x origin,clip_y origin,andclip mask. This function 
also uses these graphics context mode-dependent components: foreground, background, 
tile, stipple, ts_x origin, ts_y origin, dash_offset, dash list, 
fill _styleand fill rule. 


XDrawFilled retums a Status of zero on failure, and nonzero on success. 
For more information, see Volume One, Appendix B, X/0 Compatibility. 
Related Commands 
XClearArea, XClearWindow, XCopyArea, XCopyPlane, XDraw, XDrawArc, 
XDrawArcs, XDrawLine, XDrawLines, XDrawPoint, XDrawPoints, XDraw- 


Rectangle, XDrawRectangles, XDrawSegments, XFillArc, XFillArcs, XFill- 
Polygon, XFillRectangle, XFillRectangles. 
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Name 
XDrawImageString — draw 8-bit image text characters. 


Synopsis 
XDrawImageString (display, drawable, gC, X, Yr string, length) 

Display *display; 
Drawable drawable; 
GCUGGC; 
eee yar 
char *string; 
at. Lengen; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 


drawable Specifies the drawable. 


gc Specifies the graphics context. 
a Specify the x and y coordinates of the baseline starting position for the image 
y text character, relative to the origin of the specified drawable. 
string Specifies the character string. 
length Specifies the number of characters in the st ring argument. 
Description 


XDrawImageString draws a string, but unlike XDrawSt ring it draws both the foreground 
and the background of the characters. It draws the characters in the foreground and fills the 
bounding box with the background. 


XDrawImageString uses these graphics context components: plane _ mask, fore- 
ground, background, font, sukwindow_mode, clip _x origin, clip _y_ 
origin, and clip mask. The function and fill style defined in gc are ignored; 
the effective function is GXcopy and the effective fill style is FillSolid. 


XDrawImageString first fills a destination rectangle with the background pixel defined 
in gc, and then paints the text with the foreground pixel. The upper-left corner of the filled 
rectangle isat [x, y - font_ascent], the width is overall->width and the height is 
ascent + descent, where overall->width, ascent, and descent are as would be 
returned by XQueryTextExtents using gcand string. 


For more information, see Volume One, Chapter 6, Drawing Graphics and Text, and Chapter 5, 
The Graphics Context. 


Errors 
BadDrawable 
BadGC 
BadMatch 
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Related Commands 
XDrawImageString16, XDrawString, XDrawStringl6, XDrawText, XDraw- 
Text16, XQueryTextExtents, XQueryTextExtents16, XTextExtents, XText- 
Extents16, XTextWidth, XTextWidth16. 
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Name 
XDrawImageString16 — draw 16-bit image text characters. 


Synopsis 
XDrawImageStringl6 (display, drawable, gc, x, y, string, length) 

Display *display; 
Drawable drawable; 
CeNgcy, 
imt ky ays 
XChar2b *string; 
int length; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 


drawable Specifies the drawable. 


gc Specifies the graphics context. 
x Specify the x and y coordinates of the baseline starting position for the image 
y text character, relative to the origin of the specified drawable. 
string Specifies the character string. 
length Specifies the number of characters in the st ring argument. 
Description 


XDrawImageString16 draws a string, but unlike XDrawString16 it draws both the fore- 
ground and the background of the characters. It draws the characters in the foreground and fills 
the bounding box with the background. 


XDrawImageStringl16 uses these graphics context components: plane_mask, fore- 
ground, background, font, sukwindow_mode, clip x origin, clip_y_ 
origin, and clip _ mask. The function and fill_style defined in gc are ignored; 
the effective function is GXcopy and the effective £ill_styleis FillSolid. 


XDrawImageString16 first fills a destination rectangle with the background pixel 
defined in gc, and then paints the text with the foreground pixel. The upper-left corner of 
the filled rectangle isat [x, y - font_ascent], the width is overall->width and the 
height is ascent + descent, where overall->width, ascent, and descent are as 
would be returned by XQueryTextExtents16 using gcand string. 


For more information, see Volume One, Chapter 6, Drawing Graphics and Text, and Chapter 5, 
The Graphics Context. 


Structures 
typedef struct { 
unsigned char bytel; 
unsigned char byte2; 
} XChar2b; 
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Errors 
BadDrawable 
BadGC 
BadMatch 


Related Commands 
XDrawImageString, XDrawString, XDrawStringl6, XDrawText, XDrawText16, 
XQueryTextExtents, XQueryTextExtents16, XTextExtents, XText- 
Extents16, XTextWidth, XTextWidthl16. 
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Name 
XDrawLine — draw a line between two points. 


Synopsis 
XDrawLine (display, drawable, gc, x1, yl, x2, y2) 
Display *display; 
Drawable drawable; 
COCy gc, 
Enews Vly oe FV 7 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
drawable Specifies the drawable. 
gc Specifies the graphics context. . 
ed Specify the coordinates of the endpoints of the line relative to the drawable 
yl origin. XLine connects point (x1, y1) to point (x2, y2). 
SQ 
y2 
Description 


XDrawLine uses the components of the specified graphics context to draw a line between two 
points in the specified drawable. No pixel is drawn more than once. 


XDrawLine uses these graphics context components: function, plane_mask, 
line width, line_style, cap_style, fill_style, subwindow.mode, clip_ 
x_origin,clip_y origin,and clip mask. XDrawLine also uses these graphics con- 
text mode-dependent components: foreground, background, tile, stipple, 
ts_x origin,ts_y origin, dash_offset,and dash_list. 


For more information, see Volume One, Chapter 6, Drawing Graphics and Text, and Chapter 5, 
The Graphics Context. 


Errors 
BadDrawable Specified drawable is invalid. 
BadGC Specified GC is invalid, or does not match the depth of drawable. 
BadMatch Specified drawable is an InputOn1ly window. 


Related Commands 
XClearArea, XClearWindow, XCopyArea, XCopyP lane, XDraw, XDrawArc, 
XDrawArcs, XDrawFilled, XDrawLines, XDrawPoint, XDrawPoints, XDraw- 
Rectangle, XDrawRectangles, XDrawSegments, XFillArc, X¥FillArcs, XFill- 
Polygon, XFillRectangle, XFillRectangles. 
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Name 
XDrawLines — draw multiple connected lines. 


Synopsis 
XDrawLines (display, drawable, gc, points, npoints, mode) 

Display *display; 
Drawable drawable; 
GC gc; 
XPoint *points; 
int npoints; 
int mode; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 


drawable Specifies the drawable. 


gc Specifies the graphics context. 
points Specifies a pointer to an array of points. 
npoints Specifies the number of points in the array. 
mode Specifies the coordinate mode. Pass either CoordModeOrigin or Coord- 
ModePrevious. 
Description 


XDrawLines draws a series of lines joined end-to-end. 


It draws lines connecting each point in the list (points array) to the next point in the list. The 
lines are drawn in the order listed in the points array. For any given line, no pixel is drawn 
more than once. If thin (zero line width) lines intersect, pixels will be drawn multiple times. If 
the first and last points coincide, the first and last lines will join correctly. If wide lines inter- 
sect, the intersecting pixels are drawn only once, as though the entire multiline request were a 
single filled shape. 


There is a limit to the number of lines that can be drawn in a single call, that varies according to 
the server. To determine how many lines you can draw in a single call, you find out your 
server’s maximum request size using XMaxRequest Size. Subtract 3 and divide by two, and 
this is the maximum number of lines you can draw in a single XDrawLines call. 


The mode argument may have two values: 
° CoordModeOrigin indicates that all points are relative to the drawable’s origin. 


s CoordModePrevious indicates that all points after the first are relative to the previ- 
ous point. (The first point is always relative to the drawable’s origin.) 


XDrawLines uses the following components of the specified graphics context to draw multi- 
ple connected lines in the specified drawable: function, plane_mask, line width, 
line_style, cap_style, join_style, fill_style, subwindow_mode, 
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XDrawLines (continued) Xlib — Drawing Primitives 


clip x origin, clip _y_ origin, and clip_mask. This function also uses these 
graphics context mode-dependent components: foreground, background, tile, 
stipple,ts_x origin,ts_y origin,dash_offset, and dash_list. 


For more information, see Volume One, Chapter 6, Drawing Graphics and Text, and Chapter 5, 
The Graphics Context. 


Structures 


typedef struct { 
Short, Ve 


peEXRoant > 
Errors 
BadDrawable Specified drawable is invalid. 
BadGC Specified GC is invalid, or does not match the depth of drawable. 
BadMatch Specified drawable is an InputOn1ly window. 
BadValue Invalid coordinate_mode. 


Related Commands 
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XClearArea, XClearWindow, XCopyArea, XCopyPlane, XDraw, XDrawArc, 
XDrawArcs, XDrawFilled, XDrawLine, XDrawPoint, XDrawPoints, XDraw- 
Rectangle, XDrawRectangles, XDrawSegments, XFillArc, XFillArcs, XFill- 
Polygon, XFillRectangle, XFillRectangles. 
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Name ‘ 
XDrawPoint — draw a point. 


Synopsis 
XDrawPoint (display, drawable, gc, xX, y) 
Display *display; 
Drawable drawable; 
em OCiy, 
EG Ng YF 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 


drawable Specifies the drawable. 


gc Specifies the graphics context. 
x Specify the x and y coordinates of the point, relative to the origin of the draw- 
y able. 

Description 


XDrawPoint draws a single point into the specified drawable. XDrawPoint uses these 
graphics context components: function, plane_mask, foreground, subwin- 
dow_mode, clip_x origin, clip_y origin, and clip mask. Use XDrawPoints 
to draw multiple points. 


For more information, see Volume One, Chapter 6, Drawing Graphics and Text, and Chapter 5, 
The Graphics Context. 


Errors 
BadDrawable 
BadGC 
BadMatch 


Related Commands 
XClearArea, XClearWindow, XCopyArea, XCopyPlane, XDraw, XDrawArc, 
XDrawArcs, XDrawFilled, XDrawLine, XDrawLines, XDrawPoints, XDraw- 
Rectangle, XDrawRectangles, XDrawSegments, XFillArc, XFillArcs, XFill- 
Polygon, XFillRectangle, XFillRectangles. 
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Name 
XDrawPoints — draw multiple points. 


Synopsis 
XDrawPoints (display, drawable, gc, points, npoints, mode) 
Display *display; 
Drawable drawable; 
GC gc; 
XPoint *points; 
MMe, isfeyenlighersyy 


int mode; 
Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
drawable Specifies the drawable. 
gc Specifies the graphics context. 
points ~ Specifies a pointer to an array of XPoint structures containing the positions 
of the points. 
npoints Specifies the number of points to be drawn. 
mode Specifies the coordinate mode. CoordModeOrigin treats all coordinates as 


relative to the origin, while CoordModePrevious treats all coordinates 
after the first as relative to the previous point, while the first is still relative to 
the origin. 


Description 
XDrawPoints draws one or more points into the specified drawable. 


There is a limit to the number of points that can be drawn in a single call, that varies according 
to the server. To determine how many points you can draw in a single call, you find out your 
server’s maximum request size using XMaxRequestSize. Subtract 3 and this is the maxi- 
mum number of points you can draw ina single XDrawPoints call. 


XDrawPoints uses these graphics context components: function, plane_mask, fore- 
ground, subwindow_mode,clip_x_origin,clip_y origin,andclip mask. 


For more information, see Volume One, Chapter 6, Drawing Graphics and Text, and Chapter 5, 
The Graphics Context. 


Structures 
typedef struct { 
Ghokoneie: on 345 
} exe Cares 


158 Xlib Reference Manual - 


Xlib — Drawing Primitives (continued) XDrawPoints 


Errors } ; 
BadDrawable 
BadGC 
BadMatch 
BadValue 


Related Commands 

- XClearArea, XClearWindow, XCopyArea, XCopyPlane, XDraw, XDrawArc, 
XDrawArcs, XDrawFilled, XDrawLine, XDrawLines, XDrawPoints, XDraw- 
Rectangle, XDrawRectangles, XDrawSegments, XFillArc, XFillArcs, XFill- 
Polygon, XFillRectangle, XFillRectangles. 
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Name 
XDrawRectangle — draw an outline of a rectangle. 


Synopsis 
XDrawRectangle (display, drawable, gc, x, y, width, height) 
Display *display; 
Drawable drawable; 
CGOMGC; 
amt yay F 
unsigned int width, height; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 


drawable Specifies the drawable. 
























































gc Specifies the graphics context. 
x Specify the x and y coordinates of the upper-left corner of the rectangle, rela- 
y tive to the drawable’s origin. 
width Specify the width and height in pixels. These dimensions define the outline 
height of the rectangle. 
20 pixels 20 pixels J 
| fe : r 

































































XDrawRectangle (display, drawable, gc, 0, 0, 19, 11); XFillRectangle (display, drawable, gc, 0, 0, 19, 11); 


Description 

XDrawRectangle draws the outline of the rectangle by using the x and y coordinates, 
width and height, and graphics context you specify. Specifically, xDrawRectangle uses 
these graphics context components: function, plane mask, line width, 
line style, cap_style, join_style, fill _style, subwindow_mode, clip_ 
x origin,clip y origin,and clip mask. This function also uses these graphics con- 
text mode-dependent components: foreground, background, tile, stipple, 
ts_x origin,ts_y origin, dash_offset,anddash_ list. 


For the specified rectangle, no pixel is drawn more than once. 


For more information, see Volume One, Chapter 6, Drawing Graphics and Text, and Chapter 5, 
The Graphics Context. 
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Structure 
typedef struct { ’ ‘ 
SHORE Xe Vir 
unsigned short width, height; 
} XRectangle; 


Errors 
BadDrawable 
BadGC 
BadMatch 


Related Commands 
XClearArea, XClearWindow, XCopyArea, XCopyPlane, XDraw, XDrawArc, 
XDrawArcs, XDrawFilled, XDrawLine, XDrawLines, XDrawPoint, XDrawPoints, 
XDrawRectangles, XDrawSegments, XFillArc, XFillArcs, XFillPolygon, 
XFillRectangle, XFillRectangles. 
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Name 
XDrawRectangles — draw the outlines of multiple rectangles. 


Synopsis 
XDrawRectangles (display, drawable, gc, rectangles, nrectangles) 
Display *display; 
Drawable drawable; 
GC Vgc? 
XRectangle rectangles[]; 
int nrectangles; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
drawable Specifies the drawable. 
gc Specifies the graphics context. © 


rectangles Specifies a pointer to an array of rectangles containing position and size 
information. 


nrectangles Specifies the number of rectangles in the array. 


20 pixels 20 pixels 
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XDrawRectangle (display, drawable, gc, 0, 0, 19, 11); XFillRectangle (display, drawable, gc, 0, 0, 19, 11); 


Description 
XDrawRectangles draws the outlines of the specified rectangles by using the position and 
size values in the array of rectangles. The x and y coordinates of each rectangle are relative to 
the drawable’s origin, and define the upper-left corner of the rectangle. 


The rectangles are drawn in the order listed. For any given rectangle, no pixel is drawn more 
than once. If rectangles intersect, pixels are drawn multiple times. 


There is a limit to the number of rectangles that can be drawn in a single call. It varies accord- 
ing to the server. To determine how many rectangles you can draw in a single call, find out 
your server’s maximum request size using XMaxRequestSize. Subtract 3 and divide by 
two. This is the maximum number of rectangles you can draw in a single XDraw- 
Rectangles call. 


This function uses these graphics context components: function, plane mask, 
line width, line style, cap_style, join_style, £111 style, subwin- 
dow_mode, clip x origin,clip_y origin,andclip mask. XDrawRectangles 
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also uses these graphics context mode-dependent components: foreground, background, 
tile, stipple,ts x origin,ts_y origih,dash_offset,and dash_list. 


For more information, see Volume One, Chapter 6, Drawing Graphics and Text, and Chapter 5, 
The Graphics Context. 


Structures 
typedef struct { 
SHORE. XS, Vr 
unsigned short width, height; 
} XRectangle; 


Errors 
BadDrawable 
BadGC 
BadMatch 


Related Commands 
XClearArea, XClearWindow, XCopyArea, XCopyP lane, XDraw, XDrawArc, 
XDrawArcs, XDrawFilled, XDrawLine, XDrawLines, XDrawPoint, XDrawPoints, 
XDrawRectangle, XDrawSegments, XFillArc, XFillArcs, XFillPolygon, 
XFillRectangle, XFillRectangles. 
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Name 
XDrawSegments — draw multiple disjoint lines. 


Synopsis 
XDrawSegments (display, drawable, gc, segments, nsegments) 
Display *display; 
Drawable drawable; 
CeRgc;; 
XSegment *segments; 
int nsegments; 


Arguments | 
display Specifies a connection to an X server; returned from XOpenDisplay. 


drawable Specifies the drawable. 

gc Specifies the graphics context. 

segments Specifies a pointer to an array of line segments. 
nsegments Specifies the number of segments in the array. 


Description 
XDrawSegments draws multiple line segments into the specified drawable. Each line is 
specified by a pair of points, so the line may be connected or disjoint. 


For each segment, XDrawSegments draws a line between (x1, yl) and (x2, y2). The 
lines are drawn in the order listed in segments. For any given line, no pixel is drawn more 
than once. If lines intersect, pixels will be drawn multiple times. The lines will be drawn sepa- 
rately, without regard to the join style. 


There is a limit to the number of segments that can be drawn in a single call. It varies accord- 
ing to the server. To determine how many segments you can draw ina single call, find out your 
server’s maximum request size using XMaxRequestSize. Subtract 3 and divide by two. 
This is the maximum number of segments you can draw in a single XDrawSegments call. 


XDrawSegments uses these graphics context components: function, plane mask, 
line_width, line style, cap_style, fill_style, subwindow_mode, clip_ 
x origin, clip y origin, and clip mask. XDrawSegments also uses these graph- 
ics context mode-dependent components: foreground, background, tile, stipple, 
ts_x origin,ts_y origin, dash_offset,and dash_list. 


For more information, see Volume One, Chapter 6, Drawing Graphics and Text, and Chapter 5, 
The Graphics Context. 


Structures 
typedef struct { 
SMovoncic Sip Als See NPD 
} XSegment; 
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Errors 
BadDrawable Specified drawable is invalid. < 
BadGC Specified GC is invalid, or does not match the depth of drawable. 


BadMatch Specified drawable is an InputOn1ly window. 


Related Commands 
XClearArea, XClearWindow, XCopyArea, XCopyPlane, XDraw, XDrawArc, 
XDrawArcs, XDrawFilled, XDrawLine, XDrawLines, XDrawPoint, XDrawPoints, 
XDrawRectangle, XDrawRectangles, XFillArc, XFillArcs, XFillPolygon, 
XFillRectangle, XFillRectangles. 
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Name 
XDrawString — draw an 8-bit text string, foreground only. 


Synopsis 
XDrawString (display, drawable, gc, X, Yr string, length) 

Display *display; 
Drawable drawable; 
GCr gc, 
BETA ome Va 
char *string; 
int length; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
drawable Specifies the drawable. . 
gc Specifies the graphics context. 
x Specify the x and y coordinates of the baseline starting position for the char- 
y acter, relative to the origin of the specified drawable. 
string Specifies the character string. 
length Specifies the number of characters in st ring. 
Description 


XDrawString draws the given string into a drawable using the foreground only to draw 
set bits in the font. It does not affect any other pixels in the bounding box for each character. 


The y coordinate defines the baseline row of pixels while the x coordinate is the point from 
which lbearing, rbearing, and width are measured. 


XDrawString uses these graphics context components: function, plane_mask, 
fill_style, font, subwindow_mode, clip_x origin, clip_y origin, and 
clip mask. This function also uses these graphics context mode-dependent components: 
foreground, tile, stipple, ts_x_origin, and ts_y origin. Each character 
image, as defined by the font in gc, is treated as an additional mask for a fill operation on the 
drawable. 


For more information, see Volume One, Chapter 6, Drawing Graphics and Text, and Chapter 5, 
The Graphics Context. 


Errors 
BadDrawable 
BadFont 
BadGC 
BadMatch 
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Related Commands i 
XDrawImageString, XDrawImageStringl6,'XDrawString16, XDrawText, 
XDrawText16, XQueryTextExtents, XQueryTextExtents16, XTextExtents, 
XTextExtents16, XTextWidth, XTextWidth16. 
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Name 
XDrawString16 — draw two-byte text strings. 


Synopsis 
XDrawStringl6 (display, drawable, gc, x, y, String, length) 
Display *display; 
Drawable drawable; 
Ge gc; 
inte, “v7 
XChar2b *string; 


int length; 
Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
drawable Specifies the drawable. 
gc Specifies the graphics context. 
ea Specify the x and y coordinates of the baseline starting position for the char- 
y acter, relative to the origin of the specified drawable. 
string Specifies the character string. Characters are two bytes wide. 
length Specifies the number of characters in st ring. 
Description 
XDrawString16 draws a string in the foreground pixel value without drawing the surround- 
ing pixels. 


The y coordinate defines the baseline row of pixels while the x coordinate is the point from 
which lbearing, rbearing, and width are measured. For more information on text 
placement, see Volume One, Chapter 6, Drawing Graphics and Text. 


XDrawString16 uses these graphics context components: function, plane _mask, 
fill _ style, font, subwindow_mode, clip x origin, clip _y origin, and 
clip mask. This function also uses these graphics context mode-dependent components: 
foreground, tile, stipple, ts_x origin, and ts_y origin. Each character 
image, as defined by the font in gc, is treated as an additional mask for a fill operation on the 
drawable. 


For more information, see Volume One, Chapter 6, Drawing Graphics and Text, and Chapter 5, 
The Graphics Context. 


Structures 
typeder struct { 
unsigned char bytel; 
unsigned char byte2; 
} XChar2b; 
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Errors 
BadDrawable ‘ 
BadFont 
BadGC 
BadMatcn 


Related Commands 
XDrawImageString, XDrawImageStringl6, XDrawString, XDrawText, XDraw- 
Text16, XQueryTextExtents, XQueryTextExtents16, XTextExtents, XText- 
Extents16, XTextWidth, XTextWidthl16. 
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Name 


XDrawText — draw 8-bit polytext strings. 


Synopsis 


XDrawText (display, drawable, gc, X, Yr items, nitems) 
Display *display; 
Drawable drawable; 
GC gc; 
ant ix; *y; 
XTextItem *items; 
int nitems; 


Arguments 


display Specifies a connection to an X server; returned from XOpenDisplay. 


drawable Specifies the drawable. 


gc Specifies the graphics context. 
x Specify the x and y coordinates of the baseline starting position for the initial 
y string, relative to the origin of the specified drawable. 
items Specifies a pointer to an array of text items. 
nitems Specifies the number of text items in the items array. 
Description 
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XDrawText is capable of drawing multiple strings on the same horizontal line and changing 
fonts between strings. Each XText Item structure contains a string, the number of characters 
in the string, the delta offset from the starting position for the string, and the font. Each text 
item is processed in turn. The font in each XText Item is stored in the specified GC and used 
for subsequent text. If the XText Item. font is None, the font in the GC is used for drawing 
and is not changed. Switching between fonts with different drawing directions is permitted. 


The delta in each XText Item specifies the change in horizontal position before the string is 
drawn. The delta is always added to the character origin and is not dependent on the draw 
direction of the font. For example, if x = 40,y = 20,and items[0].delta = 8, the 
string specified by items [0] .chars would be drawn starting atx = 48,y = 20. The 
delta for the second string begins at the rbearing of the last character in the first string. A 
negative delta would tend to overlay subsequent strings on the end of the previous string. 


Only the pixels selected in the font are drawn (the background member of the GC is not used 
to fill the bounding box). 


There is a limit to the number and size of strings that can be drawn in a single call, that varies 
according to the server. To determine how much text you can draw in a single call, you find out 
your server’s maximum request size using XMaxRequestSize. Subtract four, and then sub- 
tract ((strlen(string) + 2) / 4) for each string. This is the maximum amount of 
text you can draw in a single XDrawText call. 
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XDrawText uses the following elements in the specified GC: function, plane_mask, 
fill_style, font, subwindow_mode, clip _x origin, clip_y origin, and 
clip mask. This function also uses these graphics context mode-dependent components: 
foreground, tile, stipple,ts_x_origin,andts_y origin. 


For more information, see Volume One, Chapter 6, Drawing Graphics and Text, and Chapter 5, 


The Graphics Context. 
Structures 
typedef struct { i 
char *chars; /* pointer to string */ 
imtincharsy /* number of characters */ 
int delta; /* delta between strings */ 
Font font; /* font to print it in, None don’t change !*/ 


} XTextItem; 


Errors 
BadDrawable 
BadFont 
BadGC 
BadMatch 


Related Commands 


XDrawImageString, XDrawImageString16, XDrawString, XDrawStringl16, 
XDrawText16, XQueryTextExtents, XQueryTextExtents16, XTextExtents, 
XTextExtents16, XTextWidth, XTextWidth16. 
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XDrawText16 \ Xlib - Text — 


Name 
XDrawText16 — draw 16-bit polytext strings. 


Synopsis 
XDrawText16 (display, drawable, gc, x, y, items, nitems) 

Display *display; 
Drawable drawable; 
GC gci; 
Muito) LVF 
XTextItem16 *items; 
int nitems; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 


drawable Specifies the drawable. 


gc Specifies the graphics context. 
x Specify the x and y coordinates of the baseline starting position for the initial 
y string, relative to the origin of the specified drawable. 
items Specifies a pointer to an array of text items using two-byte characters. 
nitems Specifies the number of text items in the array. 

Description 


XDrawText16 is capable of drawing multiple strings on the same horizontal line and chang- 
ing fonts between strings. Each XText It em structure contains a string, the number of charac- 
ters in the string, the delta offset from the starting position for the string, and the font. Each 
text item is processed in turn. The font in each XText Item is stored in the specified GC and 
used for subsequent text. If the XText Item16.font is None, the font in the GC is used for 
drawing and is not changed. Switching between fonts with different drawing directions is per- 
mitted. 


The delta in each XText Item specifies the change in horizontal position before the string is 
drawn. The delta is always added to the character origin and is not dependent on the drawing 
direction of the font. For example, ifx = 40,y = 20,and items[0].delta = 8, the 
string specified by items [0] .chars would be drawn starting atx = 48,y = 20. The 
delta for the second string begins at the rbearing of the last character in the first string. A 
negative delta would tend to overlay subsequent strings on the end of the previous string. 


Only the pixels selected in the font are drawn (the background member of the GC is not used 
to fill the bounding box). 


There is a limit to the number and size of strings that can be drawn in a single call, that varies 
according to the server. To determine how much text you can draw in a single call, you find out 
your server’s maximum request size using XMaxRequestSize. Subtract four, and then sub- 
tract ((strlen(string) + 2) / 4) foreach string. This is the maximum amount of 
text you can draw in a single XDrawText16 call. 
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XDrawText16 uses the following elements in the specified GC: function, plane_ mask, 
fill_style, font, subwindow_mode, clip x origin, clip _y origin, and 
clip_mask. This function also uses these graphics context mode-dependent components: 
foreground, tile, stipple,ts_x_origin,andts_y origin. 


Note that the chars member of the XText Item16 structure is of type XChar2b, rather than 
of type char as it is in the XTextItem structure. For fonts defined with linear indexing 
rather than two-byte matrix indexing, the X server will interpret each member of the XChar2b 
- Structure as a 16-bit number that has been transmitted most significant byte first. In other 
words, the byte1 member of the XChar2b structure is taken as the most significant byte. 


For more information, see Volume One, Chapter 6, Drawing Graphics and Text, and Chapter 5, 
The Graphics Context. 


Structures 
typedef struct { 
XChar2b *chars; /* 2 byte characters */ 
int nchars; /* number of characters */ 
int delta; /* delta between strings */ 
Bont font / 7* font "co print atin, None’ don"t change) 
} XTextItem16; 
typedef struct { /* normal 16 bit characters are two bytes */ 


unsigned char bytel; 
unsigned char byte2; 
}OXGChaAr ZO 


Errors 


BadDrawable 
BadFont 
BadGC 
BadMatch 


Reiated Commands 


XDrawImageString, XDrawImageStringl6, XDrawString, XDrawStringl6, 
XDrawText, XQueryTextExtents, XQueryTextExtents16, XTextExtents, 
XTextExtents16, XTextWidth, XTextWidthl16. 
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XEmptyRegion Xlib — Regions— 


Name 
XEmptyRegion — determine if a region is empty. 


Synopsis 
Bool XEmptyRegion (r) 
Region r; 


Arguments 
ie Specifies the region to be checked. 


Description 
XEmptyRegion will return True if the specified region is empty, or False otherwise. 


Structures 
Region is a pointer to an opaque structure type. 


Related Commands 
XClipBox, XCreateRegion, XDest royRegion, XEqualRegion, XIntersect- 
Region, XOffsetRegion, XPointInRegion, XPolygonRegion, XRectInRegion, 
XSetRegion, XShrinkRegion, XSubtractRegion, XUnionRectWithRegion, 
XUnionRegion, XXorRegion. 
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Name : 
XEnableAccessControl — use access control list to allow or deny connection requests. 
Synopsis 
XEnableAccessControl (display) 
Display *display; 


_ Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 


Description 
XEnableAccessControl instructs the server to use the host access list to determine 
whether access should be granted to clients seeking a connection with the server. 


By default, the host access list is used. If access has not been disabled with xDisable- 
AccessControl or XSetAccessControl, this routine does nothing. 


This routine can only be called by clients running on the same host as the server. 
For more information, see Volume One, Chapter 13, Other Programming Techniques. 


Errors 
BadAccess 


Related Commands 
XAddHost, XAddHosts, XDisableAccessControl, XListHosts, XRemoveHost, 
XRemoveHosts, XSetAccessControl. 
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Name 
XEqualRegion — determine if two regions have the same size, offset, and shape. 
Synopsis 
Bool XEqualRegion(ri1, r2) 
Region rl, r2; 


Arguments 
rl Specify the two regions you want to compare. 
r2 


Description 
XEqualRegion returns True if the two regions are identical; i.e., they have the same offset, 
size and shape, or False otherwise. 


Regions are located using an offset from a point (the region origin) which is common to all 
regions. It is up to the application to interpret the location of the region relative to a drawable. 


For more information, see Volume One, Chapter 6, Drawing Graphics and Text. 


Structures 
Region is a pointer to an opaque structure type. 


Related Commands | 
XClipBox, XCreateRegion, XDest royRegion, XEmpt yRegion, XIntersect- 
Region, XOffsetRegion, XPoint InRegion, XPolygonRegion, XRect InRegion, 
XSetRegion, XShrinkRegion, XSubtractRegion, XUnionRectWithRegion, 
XUnionRegion, XXorRegion. 
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Name i 
XEventsQueued — check the number of events in the event queue. 


Synopsis 
int XEventsQueued (display, mode) 
Display *display; 


int mode; 
Arguments * 
display Specifies a connection to a Display structure, returned from XOpen- 
Display. - 
mode Specifies whether the request buffer is flushed if there are no events in Xlib’s 


queue. You can specify one of these constants: QueuedAlready, 
QueuedAfterFlush, QueuedAfterReading. 


Description 
XEvent sQueued checks whether events are queued. If there are events in Xlib’s queue, the 
routine returns immediately to the calling routine. Its return value is the number of events 
regardless of mode. 


mode specifies what happens if no events are found on Xlib’s queue. 


® If mode is QueuedAlready, and there are no events in the queue, XEvents- 
Queued returns zero (it does not flush the request buffer or attempt to read more 
events from the connection). 


° If mode is QueuedAfterF lush, and there are no events in the queue, XEvents- 
Queued flushes the request buffer, attempts to read more events out of the applica- 
tion’s connection, and returns the number read. 


° If mode is QueuedAfterReading, and there are no events in the queue, 
XEvent sQueued attempts to read more events out of the application’s connection 
without flushing the request buffer and returns the number read. 


Note that XEventsQueued always returns immediately without I/O if there are events 
already in the queue. 


XEventsQueued with mode QueuedAfterF lush is identical in behavior to XPending. 
XEventsQueued with mode QueuvedAlready is identical to the QLength macro (see 
Appendix C, Macros). 


For more information, see Volume One, Chapter 8, Events. 


Related Commands 
QLength, XAllowEvents, XCheckIfEvent, XCheckMaskEvent, XCheckTyped- 
Event, XCheckTypedWindowEvent, XCheckWindowEvent, XGet InputFocus, 
XGetMotionEvents, XIfEvent, XMaskEvent, XNextEvent, XPeekEvent, XPeek- 
IfEvent, XPending, XPutBackEvent, XSelect Input, XSendEvent, XSet Input- 
Focus, XSynchronize, XWindowEvent. : 
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Name 
XFetchBuffer — return data from a cut buffer. 


Synopsis 
char *XFetchBuffer (display, nbytes, buffer) 
Display *display; 
int *nbytes; /* RETURN */ 
int buffer; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
nbytes Returns the number of bytes in buffer returned by XFetchBuffer. If 
there is no data in the buffer, *nbytes.§is set to 0. 
buffer Specifies which buffer you want data from. Specify an integer from 0 to 7 
inclusive. 
Description 


XFetchBuffer returns data from one of the 8 buffers provided for interclient communica- 
tion. If the buffer contains data, XFetchBuffer returns the number of bytes in nbytes, | 
otherwise it returns NULL and sets *nbytes to 0. The appropriate amount of storage is allo- 
cated and the pointer returned; the client must free this storage when finished with it by calling 
XF ree. Note that the cut buffer does not necessarily contain text, so it may contain embedded 
null bytes and may not terminate with a null byte. 


Selections are preferred over cut buffers as a communication scheme. 
For more information on cut buffers, see Volume One, Chapter 13, Other Programming Tech- 
niques. 


Errors 
BadValue buffer not an integer between 0 and 7 inclusive. 


Related Commands 
XFetchBytes, XRotateBuffers, XStoreBuffer, XStoreBytes. 
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Name 
XFetchBytes — return data from cut buffer 0. 


Synopsis 
char *XFetchBytes (display, nbytes) 
Display *display; 


int *nbytes; /* RETURN */ 
‘Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
nbytes Returns the number of bytes in the string returned by XFetchBytes. If 


there is no data in the buffer, *nbytes is set to 0. 


Description 
XFetchBytes returns data from cut buffer 0 of the 8 buffers provided for interclient commu- 
nication. If the buffer contains data, XFet chBytes returns the number of bytes in nbytes, 
otherwise it returns NULL and sets *nbytes to 0. The appropriate amount of storage is allo- 
cated and the pointer returned; the client must free this storage when finished with it by calling 
XF ree. Note that the cut buffer does not necessarily contain text, so it may contain embedded 
null bytes and may not terminate with a null byte. 


Use XFetchBuf fer to fetch data from any specified cut buffer. 

Selections are preferred over cut buffers as a communication method. 

For more information on cut buffers, see Volume One, Chapter 13, Other Programming Tech- 
niques. 


Related Commands 
XFetchBuffer, XRotateBuffers, XStoreBuffer, XStoreBytes. 
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XFetchName Xlib — Window Manager Hints— 


Name 
XFetchName — get a window’s name (XA_WM_NAME property). 


Synopsis 
Status XFetchName (display, w, window_name) 
Display *display; 
Window w; 


char **window_name; /* RETURN */ 
Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
w Specifies the ID of the window whose name you want a pointer set to. 


window name Returns a pointer to the window name, which will be a null-terminated string. 
If the XA_WM _NAME property has not been set for this window, XFet chName 
sets windowname to NULL. When finished with it, a client can free the name 
string using XF ree. 


Description 
XFetchName is superseded by XGet WMName in Release 4. XFet chName returns the current 
value of the XA_WM NAME property for the specified window. XFet chName returns nonzero if 
it succeeds, and zero if the property has not been set for the argument window. 


For more information, see Volume One, Chapter 10, Interclient Communication, and Chapter 
14, Window Management. 


Errors 
BadWindow 


Related Commands 
XGetClassHint, XGetIconName, XGetIconSizes, XGetNormalHints, XGet- 
SizeHints, XGetTransientForHint, XGetWMHints, XGetZoomHints, XSet- 
ClassHint, XSetCommand, XSet IconName, XSetIconSizes, XSetNormalHints, 
XSetSizeHints, XSetTransientForHint, XSetWMHints, XSetZoomHints, 
XStoreName. 
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Name 
XFillArc — fill an arc. ‘ 


Synopsis 
XPillAre (display, drawable; gc, *,; y, width, height, 

anglel, angle2) 

Display *display; 

Drawable drawable; 

GGugc,; 

Ini pe ye 

unsigned int width, height; 

int anglel, angle2; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 


drawable Specifies the drawable. 


gc Specifies the graphics context. 

x Specify the x and y coordinates of the upper-left corner of the bounding box 
y containing the arc, relative to the origin of the drawable. 

width Specify the width and height in pixels. These are the major and minor axes of 
height the arc. 

anglel Specifies the start of the arc relative to the three-o’clock position from the 


center. Angles are specified in 64ths of degrees. 


angle2 Specifies the path and extent of the arc relative to the start of the arc. Angles 
are specified in 64ths of degrees. 


Description 
XFillArc draws a filled arc. The x, y, width, and height arguments specify the bounding 
box for the arc. See XDrawArc for the description of how this bounding box is used to com- 
pute the arc. Some, but not all, of the pixels drawn with XDrawArc will be drawn by XFill- 
Arc with the same arguments. See XFillRectangle for an example of the differences in 
pixels drawn by the draw and fill routines. 


The arc forms one boundary of the area to be filled. The other boundary is determined by the 
arc_mode in the GC. If the arc_mode in the GC is ArcChord, the single line segment 
joining the endpoints of the arc is used. If ArcPieSlice, the two line segments joining the 
endpoints of the arc with the center point are used. 

XFillArc uses these graphics context components: function, plane_mask, 
fill _ style, arc_mode, subwindow_mode,clip x origin,clip y origin, and 
clip _mask. This function also uses these graphics context mode-dependent components: 
foreground, background, tile, stipple,ts_x origin,andts_y origin. 


For more information, see Volume One, ad. 6, Drawing Graphics and Text, and Chapter 5, 
The Graphics Context. 
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Errors 
BadDrawable 
BadGC 
BadMatch 


Related Commands 
XClearArea, XClearWindow, XCopyArea, XCopyPlane, XDraw, XDrawArc, 
XDrawArcs, XDrawFilled, XDrawLine, XDrawLines, XDrawPoint, XDrawPoints, 
XDrawRectangle, XDrawRectangles, XDrawSegments, XFillArcs, XFill- 
Polygon, XFillRectangle, XFillRectangles. 
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J XFillArcs 
— Xlib — Drawing Primitives 


Name 
XFillArcs — fill multiple arcs. ‘ 


Synopsis 
XFillArcs (display, drawable, gc, arcs, narcs) 
Display *display; 
Drawable drawable; 
GC gc; 
XArc *arcs; 
int narcs; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 


drawable Specifies the drawable. 


gc Specifies the graphics context. 

arcs Specifies a pointer to an array of arc definitions. 

narcs Specifies the number of arcs in the array. 
Description 


For each arc, XFillArcs fills the region closed by the specified arc and one or two line seg- 
ments, depending on the arc_mode specified in the GC. It does not draw the complete out- 
lines of the arcs, but some pixels may overlap. 


The arc forms one boundary of the area to be filled. The other boundary is determined by the 
arc_mode in the GC. If the arc_mode in the GC is ArcChord, the single line segment 
joining the endpoints of the arc is used. If ArccPieSlice, the two line segments joining the 
endpoints of the arc with the center point are used. The arcs are filled in the order listed in the 
array. For any given arc, no pixel is drawn more than once. If filled arcs intersect, pixels will 
be drawn multiple times. 


There is a limit to the number of arcs that can be filled in a single call, that varies according to 
the server. To determine how many arcs you can fill in a single call, you find out your server’s 
maximum request size using XMaxRequestSize. Subtract 3 and divide by three, and this is 
the maximum number of arcs you can fill in a single XFillArcs call. 


XFillArcs use these graphics context components: function, plane mask, 
fill_style, arc_mode, subwindow_mode,clip_x origin,clip_y origin, and 
clip mask. This function also uses these graphics context mode-dependent components: 
foreground, background, tile,stipple,ts x origin,andts y origin. 


For more information, see Volume One, Chapter 6, Drawing Graphics and Text, and Chapter S, 
The Graphics Context. 


Structures 
typedef struct { 
short *, Yi 
unsigned short width, height; 
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short anglel, angle2; /* 64ths of Degrees */ 
} XArc; 


Errors 
BadDrawable 
BadGC 
BadMatch 


Related Commands 
XClearArea, XClearWindow, XCopyArea, XCopyPlane, XDraw, XDrawArc, 
XDrawArcs, XDrawFilled, XDrawLine, XDrawLines, XDrawPoint, XDrawPoints, 
XDrawRectangle, XDrawRectangles, XDrawSegments, XFillArc, XFill- 
Polygon, XFillRectangle, XFillRectangles. 
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Name 
XFillPolygon — fill a polygon. 


Synopsis 
XFillPolygon (display, drawable, gc, points, npoints, shape, mode) 

Display *display; 
Drawable drawable; 
GC gc; 
XPoint *points; 
Int ApOLnes 7 
int shape; 
int mode; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 


drawable Specifies the drawable. 


gc Specifies the graphics context. 

points Specifies a pointer to an array of points. 

npoints Specifies the number of points in the array. 

shape Specifies an argument that helps the server to improve performance. Pass the 


last constant in this list that is valid for the polygon to be filled: Complex, 
Nonconvex, or Convex. 


mode Specifies the coordinate mode. Pass either CoordModeOrigin or Coord- 
ModePrevious. 


Description 
XFill1Polygon fills the region closed by the specified path. Some but not all of the path 
itself will be drawn. The path is closed automatically if the last point in the list does not coin- 
cide with the first point. No pixel of the region is drawn more than once. 


The mode argument affects the interpretation of the points that define the polygon: 
° CoordModeOrigin indicates that all points are relative to the drawable’s origin. 


° CoordModeP revious indicates that all points after the first are relative to the previ- 
ous point. (The first point is always relative to the drawable’s origin.) 


The shape argument allows the fill routine to optimize its performance given tips on the confi- 
guration of the area. 


° Complex indicates the path may self-intersect. The f£il1 rule of the GC must be 
consulted to determine which areas are filled. See Volume One, Chapter 5, The Graphics 
Context, for a discussion of the fill rules EvenOddRule and WindingRule. 
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° Nonconve:x indicates the path does not self-intersect, but the shape is not wholly con- 
vex. If known by the client, specifying Nonconvex instead of Complex may improve 
performance. If you specify Nonconvex for a self-intersecting path, the graphics 
results are undefined. 


° Convex means that for every pair of points inside the polygon, the line segment con- 
necting them does not intersect the path. This can improve performance even more, but 
if the path is not convex, the graphics results are undefined. 


Contiguous coincident points in the path are not treated as self-intersection. 


XFillPolygon uses these graphics context components when filling the polygon area: 
function, plane_mask, fill style, fill_rule, subwindow_mode, clip_ 
x _origin,clip_y origin,and clip mask. This function also uses these mode-depen- 
dent components of the GC: foreground, background, tile, stipple, 
ts_x origin,andts_y origin. 


For more information, see Volume One, Chapter 6, Drawing Graphics and Text, and Chapter 5, 
The Graphics Context. 


Structures 
typedef struct { 
igveneie, 2." 425 
) MMOs ghey 


Errors 
BadDrawable 
BadGC 
BadMatch 
BadValue 


Related Commands 
XClearArea, XClearWindow, XCopyArea, XCopyP lane, XDraw, XDrawArc, 
XDrawArcs, XDrawFilled, XDrawLine, XDrawLines, XDrawPoint, XDrawPoints, 
XDrawRectangle, XDrawRectangles, XDrawSegments, XFillArc, XFillArcs, 
XFillRectangle, XFillRectangles. 
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— Xlib — Drawing Primitives XFill Rectangle 


Name 
XFillRectangle — fill a secnnolat” area. 


Synopsis 
XFillRectangle (display, drawable, gc, x, y, width, height) 
Display *display; 
Drawable drawable; 
GE tgC; 
inex; hys 
unsigned int width, height; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 


drawable Specifies the drawable. 


gc Specifies the graphics context. 

x Specify the x and y coordinates of the upper-left corner of the rectangle, rela- 
y tive to the origin of the drawable. 

width Specify the dimensions in pixels of the rectangle to be filled. 
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XDrawRectangle (display, drawable, gc, 0, 0, 19, 11); XFillRectangle (display, drawable, gc, 0, 0, 19, 11); 
Description 

XFillRectangle fills the rectangular area in the specified drawable using the x and y coor- 
dinates, width and height dimensions, and graphics context you specify. XFill- 
Rectangle draws some but not all of the path drawn by XDrawRectangle with the same 
arguments. 
XFillRectangle uses these graphics context components: function, plane _ mask, 
fill style, subwindow_mode, clip_x_origin, clip_y origin, and clip_ 
mask. This function also uses these graphics context components depending on the 
fill_style: foreground, background tile, ‘stapple, ts x oragin, “and 
ts_y origin. 

_ For more information, see Volume One, Chapter 6, Drawing Graphics and Text, and Chapter 5, 
The Graphics Context. 


Xlib Reference Manual ; ‘ 187 


XFillRectangle (continued) Xlib — Drawing Primitives 


Errors 
BadDrawable 
BadGC 
BadMatch 


Related Commands 
XClearArea, XClearWindow, XCopyArea, XCopyPlane, XDraw, XDrawArc, 
XDrawArcs, XDrawFilled, XDrawLine, XDrawLines, XDrawPoint, XDrawPoints, 
XDrawRectangle, XDrawRectangles, XDrawSegments, XFillArc, XFillArcs, 
XFil1lPolygon, XFillRectangles. 
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— Xlib - Drawing Primitives XFillRectangles 


Name ; 
XFillRectangles — fill multiple rectangular areas. 


Synopsis 
XFillRectangles (display, drawable, gc, rectangles, nrectangles) 
Display *display; 
Drawable drawable; 
GC Oc; 
XRectangle *rectangles; 
int nrectangles; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
drawable Specifies the drawable. 
gc Specifies the graphics context. 
rectangles Specifies a pointer to an array of rectangles. 
nrectangles Specifies the number of rectangles in the array. 



















































20 pixels 20 pixels 
Pe pe Pe 
Pe 
PE 
y e Pe 
o i) Pee 
a a Pee 
a nu Pet 
Pe 
POC 
Sooo 
ea a es fs a a 
XDrawRectangle (display, drawable, gc, 0, 0, 19, 11); XFillRectangle (display, drawable, gc, 0, 0, 19, 11); 
Description 


XFillRectangles fills multiple rectangular areas in the specified drawable using the graph- 
ics context. 


The x and y coordinates of each rectangle are relative to the drawable’s origin, and define the 
upper left corner of the rectangle. The rectangles are drawn in the order listed. For any given 
rectangle, no pixel is drawn more than once. If rectangles intersect, the intersecting pixels will 
be drawn multiple times. 


There is a limit to the number of rectangles that can be filled in a single call, that varies accord- 
ing to the server. To determine how many rectangles you can fill in a single call, you find out 
your server’s maximum request size using XMaxRequestSize. Subtract 3 and divide by 
two, and this is the maximum number of rectangles you can fill in a single xDraw- 
Rectangles call. 


XFillRectangles uses these graphics context components: function, plane _ mask, 
fill _ style, subwindow_mode, clip_x_origin, clip_y origin, and clip_ 
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mask. This function also uses these graphics context components depending on the £i11_ 
style: foreground, background, tile, stipple, ts_x origin, and ts y_ 
origin. 

For more information, see Volume One, Chapter 6, Drawing Graphics and Text, and Chapter 5, 
The Graphics Context. 


Structures 
typedef struct { 
SHOE x7 ys 
unsigned short width, height; 
} XRectangle; 


Errors 
BadDrawable 
BadGC 
BadMatch 


Related Commands 
XClearArea, XClearWindow, XCopyArea, XCopyPlane, XDraw, XDrawArc, 
XDrawArcs, XDrawFilled, XDrawLine, XDrawLines, XDrawPoint, XDrawPoints, 
XDrawRectangle, XDrawRectangles, XDrawSegments, XFillArc, XFillArcs, 
XFil1lPolygon, XFillRectangle, XFillRectangles. 
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— Xlib — Context Manager XFindContext 


Name 
XFindContext — get data from the context manager (not graphics context). 


Synopsis 
int XFindContext (display, w, context, data) 
Display *display; 


Window w; 
XContext context; 
caddr data: -- {* RETURN -*/ 
Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
w Specifies the window with which the data is associated. 
context Specifies the context type to which the data corresponds. 
_ data Returns the data. 
Description 


XFindContext gets data that has been assigned to the specified window and context ID. The 
context manager is used to associate data with windows for use within an application. 


This application should have called XUniqueContext to get a unique ID, and then XSave- 
Context to save the data into the array. The meaning of the data is indicated by the context 
ID, but is completely up to the client. 


XFindContext returns XCNOENT (a nonzero error code) if the context could not be found and 
zero (0) otherwise. 


For more information on the context manager, see Volume One, Chapter 13, Other Program- 
ming Techniques. 


Structures 
typedef int XContext; 


Related Commands 
XDeleteContext, XSaveContext, XUniqueContext. 
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XFlush =p — output Buffer— 


Name 
XFlush — flush the request buffer (display all queued requests). 


Synopsis 
XF lush (display) 
Display *display; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 


Description 
XF lush sends to the server (“flushes”) all requests that have been buffered but not yet sent. 


Flushing is done automatically when input is read if no matching events are in Xlib’s queue 
(with XPending, XNextEvent, or XWindowEvent, etc.), or when a call is made that gets 
information from the server (such as XQueryPointer, XGetFont Info) so XFlush is sel- 
dom needed. It is used when the buffer must be flushed before any of these calls are reached. 


For more information, see Volume One, Chapter 2, X Concepts, and Chapter 3, Basic Window 
Program. 


Related Commands 
XSync. 
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Name ; 
XForceScreenSaver — turn the screen saver on or off. 
Synopsis 
XForceScreenSaver (display, mode) 
Display *display; 


int mode; 
Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
mode Specifies whether the screen saver is active or reset. The possible modes are: 


ScreenSaverActive or ScreenSaverReset. 


Description 
XForceScreenSaver resets or activates the screen saver. 


If the specified mode is ScreenSaverActive and the screen saver currently is disabled, the 

_screen saver is activated, even if the screen saver had been disabled by calling xSet Screen- 
Saver with a timeout of zero (0). This means that the screen may go blank or have some ran- 
dom change take place to save the phosphors. 


If the specified mode is ScreenSaverReset and the screen saver currently is enabled, the 
screen is returned to normal, the screen saver is deactivated and the activation timer is reset to 
its initial state (as if device input had been received). Expose events may be generated on all 
visible windows if the server cannot save the entire screen contents. 


For more information on the screen saver, see Volume One, Chapter 13, Other Programming 
Techniques. 


Errors 
BadValue 


Related Commands 


XActivateScreenSaver, XGetScreenSaver, XReset ScreenSaver, XSet- 
ScreenSaver. 
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XFree Xlib — HouseKeeping — 


Name 
XFree — free specified memory allocated by an Xlib function. 


Synopsis 
XF ree (data) 
caddr_ t data; 


Arguments 
data Specifies a pointer to the data that is to be freed. 


Description 
XF ree is a general purpose routine for freeing memory allocated by Xlib calls. 


Related Commands 
DefaultScreen, XCloseDisplay, XNoOp, XOpenDisplay. 
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— xe Cattrineps XFreeColormap 


Name 
XFreeColormap — delete a colormap and install the default colormap. 


Synopsis 
XFreeColormap (display, cmap) 
Display *display; 
Colormap cmap; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
cmap Specifies the colormap to delete. 

Description 


XFreeColormap destroys the specified colormap, unless it is the default colormap for a 
screen. That is, it not only uninstalls cmap from the hardware colormap if it is installed, but 
also frees the associated memory including the colormap ID. 


XF reeColormap performs the following processing: 


° If cmap is an installed map for a screen, it uninstalls the colormap and installs the default 
if not already installed. 
° If cmap is defined as the colormap attribute for a window (by XCreateWindow or 


XChangeWindowAttributes), it changes the colormap attribute for the window to 
the constant None, generates a ColormapNotify event, and frees the colormap. The 
colors displayed with a colormap of None are server-dependent, since the default color- 
map is normally used. 


For more information, see Volume One, Chapter 7, Color. 


Errors 
BadColormap 


Related Commands 
DefaultColormap, DisplayCells, XCopyColormapAndF ree, XCreate- 
Colormap, XGetStandardColormap, XInstallColormap, XListInstalled- 
Colormaps, XSetStandardColormap, XSetWindowColormap, XUninstall- 
Colormap. 
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XFreeColors Xlib — Color Cells— 


Name 
XFreeColors — free colormap cells or planes. 


Synopsis 
XFreeColors (display, cmap, pixels, npixels, planes) 
Display *display; 
Colormap cmap; 
unsigned long pixels[]; 
int npixels; 
unsigned long planes; 


Arguments 


display Specifies a.connection to an X server; returned from XOpenDisplay. 
cmap Specifies the colormap. 
pixels Specifies an array of pixel values. 
npixels Specifies the number of pixels. 
planes Specifies the planes you want to free. 
Description 


XFreeColors frees the cells whose values are computed by ORing together subsets of the 
planes argument with each pixel value in the pixels array. 


If the cells are read/write, they become available for reuse, unless they were allocated with 
XAllocColorPlanes, in which case all the related pixels may need to be freed before any 
become available. 


If the cells were read-only, they become available only if this is the last client to have allocated 
those shared cells. 


For more information, see Volume One, Chapter 7, Color. 
Errors 


BadAccess Attempt to free a colorcell not allocated by this client (either unallocated or 
allocated by another client). 


BadColormap 
BadValue A pixel value is not a valid index into cmap. 
Note: if more than one pixel value is in error, the one reported is arbitrary. 
Related Commands 
BlackPixel, WhitePixel, XAllocColor, XAllocColorCells, XAllocColor- 


Planes, XAllocNamedColor, XLookupColor, XParseColor, XQueryColor, 
XQueryColors, XStoreColor, XStoreColors, XStoreNamedColor. 
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yan es XFreeCursor 


Name ’ 
XFreeCursor — release a cursor. ‘ 
Synopsis 
XFreeCursor (display, cursor) 
Display *display; 
Cursor Cursor, 


_ Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
cursor Specifies the ID of the cursor to be affected. 
Description 


XFreeCursor deletes the association between the cursor ID and the specified cursor. The 
cursor storage is freed when all other clients have freed it. Windows with their cursor attribute 
set to this cursor will have this attribute set to None (which implies CopyFromParent). The 
specified cursor ID should not be referred to again. 


Errors 
BadCursor 


Related Commands 
XCreateFontCursor, XCreateGlyphCursor, XCreatePixmapCursor, XDefine- 
Cursor, XQueryBestCursor, XQueryBestSize, XRecolorCursor, XUndefine- 
Cursor. 
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XFreeExtensionList \ Wits succes 


Name 
XFreeExtensionList — free memory allocated for a list of installed extensions. 


Synopsis 
XFreeExtensionList (list) 
char **list; 


Arguments 
Ji Sy Specifies a pointer to the list of extensions returned from XList- 
Extensions. 
Description 


XFreeExtensionList frees the memory allocated by XListExtensions. 


For more information, see Volume One, Chapter 13, Other Programming Techniques. 


Related Commands 
XListExtensions, XQueryExtension. 
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—Xlib — Fonts XFreeFont 


Name 
XFreeFont — unload a font and free storage for the font structure. 


Synopsis 
XFreeFont (display, font_struct) 
Display *display; 
XFontStruct *font_struct; 


_ Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 


font_struct Specifies the storage associated with the font. 


Description 
XFreeFont frees the memory allocated for the font_struct font information structure 
(XFontStruct) filled by XQueryFont or XLoadQueryFont. XFreeFont frees all stor- 
age associated with the font_struct argument. Neither the data nor the font should be ref- 
erenced again. 


The server unloads the font itself if no other client has loaded it. 


For more information, see Volume One, Chapter 6, Drawing Graphics and Text. 


Structures 
typedef struct { 
XExtData *ext_data; /* hook for extension to hang data */ 
Font fid; /* Pont iD for thas font. </ 
unsigned direction; /* hint about direction the font is painted */ 


unsigned, min char or byte2; . /* first character */ 
unsigned max_char or byte2; /* last character */ 


unsigned min_bytel; /* fiwsterow that exists. */, 

unsigned max_bytel; /* last row that exists */ 

Bool all chars exist; /* flag if all characters have nonzero size*/ 
unsigned default char; /* char to print for undefined character */ 

int n_properties; /* how many properties there are */ 

XFontProp *properties; /* pointer to array of additional properties*/ 
XCharStruct min_bounds; /* minimum bounds over all existing char*/ 
XCharStruct max_bounds; /* minimum bounds over all existing char*/ 
xCharsStruct. *per ichar; /*A ticstwchar to lastucharyintormat om: */) 

int ascent; /* logical extent above baseline for spacing */ 
int descent; /* logical descent below baseline for spacing */ 


} XFontStruct; 


Errors 
BadFont 


Related Commands 
XCreateFontCursor, XFreeFont Info, XFreeFontNames, XFreeFontPath, 
XGetFontPath, XGetFontProperty, XListFonts, XListFontswWithInfo, 
XLoadFont, XLoadQueryFont, XQueryFont, XSetFont, XSetFontPath, 
“XUnloadFont. 
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XFreeFontinfo \ Xlib - Fonts — 


Name 
XFreeFontInfo — free the memory allocated by XListFontsWithInfo. 


Synopsis 
XFreeFontInfo (names, 
char **names; 
OVO SRE TADYSIE wala iaieyy 
amt actual count; 


info, actual_count) 


Arguments 
names Specifies a pointer to the list of font names that were returned by XList- 
FontsWithInfo. 
info Specifies a pointer to the list of font information that was returned by 


XListFontswWithInfo. 


actual count 
Specifies the number of matched font names returned by XListFonts- 
WithInfo. 


Description 
XFreeFontInfo frees the list of font information structures allocated by XListFonts- 
WithInfo. It does not unload the specified fonts themselves. 


Structures 
typedef struct { 

XExtData *ext_data; /* hook for extension to hang data */ 
Bonk, bids 7X ont, De for tims! Lome x) 
unsigned direction; /* hint about direction the font is painted */ 
insigned min, char or byte2,, 9/* “tirst character 7 
unsigned max_char_or byte2; /* last character */ 
unsigned min_bytel; /* first row that exists */ 
unsigned max_bytel; /* last row that exists */ 
Boole ali chars exlsty /* flag if all characters have nonzero size*/ 
unsigned default char; /* char to print for undefined character */ 
int n_ properties; /* how many properties there are */ 


XFontProp *properties; 


pointer to array of additional properties*/ 


XCharStruct min_bounds; /* minimum bounds over all existing char*/ 
XCharStruct max_bounds; /* minimum bounds over all existing char*/ 
XCharStruct *per char; /* first_char to last char information */ 
int ascent; /* logical extent above baseline for spacing */ 


int descent; 


logical descent below baseline for spacing */ 


} XFontStruct; 


Related Commands 
XCreateFontCursor, XFreeFont, XFreeFontNames, XGetFontPath, XGetFont- 
Property, XListFonts, XListFontsWithInfo, XLoadFont, XLoadQueryFont, 
XQueryFont, XSetFont, XSetFontPath, XUnloadFont. 
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—_Xtib — Fonts XFreeFontNames 


Name 
XFreeFontNames — free the memory allocated by XListFonts. 


Synopsis 
XFreeFontNames (list) 
chan) #27 seéeil|k; 


Arguments 

Liiet: Specifies the array of font name strings to be freed. 
Description - 

XF reeFontNames frees the array of strings returned by XListFonts. 


Related Commands 
XCreateFontCursor, XFreeFont, XFreeFontInfo, XFreeFontPath, XGetFont- 
Path, XGetFontProperty, XListFonts, XListFontsWithInfo, XLoadFont, 
XLoadQueryFont, XQueryFont, XSetFont, XSetFontPath, XUnloadFont. 
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XFreeFontPath \ Xlib — Fonts — 


Name 
XFreeFontPath — free the memory allocated by XGet FontPath. 


Synopsis 
XFreeFontPath (list) 
char **list; 


Arguments 
list Specifies an array of strings allocated by XGet FontPath. 

Description 
XFreeFontPath frees the data used by the array of pathnames returned by XGetFont- 
Path. 


For more information, see Volume One, Chapter 6, Drawing Graphics and Text. 


Related Commands 
XCreateFontCursor, XFreeFont, XFreeFontInfo, XFreeFontNames, XGet- 
FontPath, XGetFontProperty, XListFonts, XListFontsWithInfo, XLoad- 
Font, XLoadQueryFont, XQueryFont, XSetFont, XSetFontPath, XUnloadFont. 
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—Xlib — Graphics Context XFreeGC 


Name 
XFreeGC — free a graphics context. ‘ 


Synopsis 
XFreeGC (display, gc) 
Display *display; 


GE IC; 
‘Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
gc Specifies the graphics context to be freed. 
Description 


XFreeGC frees all memory associated with a graphics context, and removes the GC from the 
server and display hardware. 


For more information, see Volume One, Chapter 5, The Graphics Context. 


Errors 
BadGC 


Related Commands 
DefaultGC, XChangeGC, XCopyGC, XCreateGC, XGContextFromGC, XSetArcMode, 
XSetBackground, XSetClipMask, XSetClipOrigin, XSetClipRectangles, 
XSetDashes, XSetFillRule, XSetFillStyle, XSetForeground, XSet- 
Function, XSetGraphicsExposures, XSetLineAttributes, XSetPlaneMask, 
XSetState, XSetStipple, XSetSubwindowMode, XSetTSOrigin. 
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XFreeModifiermap \ Xlib - Keyboard — 


Name 
XFreeModifiermap — destroy and free a keyboard modifier mapping structure. 


Synopsis 
XFreeModifiermap (modmap) 
XModifierKeymap *modmap; 


Arguments 
modmap Specifies a pointer to the XModifierKeymap structure to be freed. 


Description 
XF reeModifiermap frees an XModifierKeymap structure originally allocated by XNew- 
ModifierMap or XGetModifierMapping. 


For more information, see Volume One, Chapter 9, The Keyboard and Pointer. 


Structures 
typedef struct { 
int max _keypermod; /* server's max number of keys per modifier */ 
KeyCode *modifiermap; /* an 8 by max _keypermod array of 
* keycodes to be used as modifiers */ 
} XModifierKeymap; 


Related Commands 
XChangeKeyboardMapping, XDeleteModifiermapEntry, XGetKeyboard- 
Mapping, XGetModifierMapping, XInsertModifiermapEntry, XKeycode- 
ToKeysym, XKeysymToKeycode, XKeysymToString, XLookupKeysym, XLookup- 
String, XNewModifierMap, XQueryKeymap, XRebindKeySym, XRefresh- 
KeyboardMapping, XSetModifierMapping, XStringToKeysym. 
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— Xlib — Pixmaps and Tiles-——————_ XFreePixmap 


Name | 
XFreePixmap — free a pixmap ID. ‘ 
Synopsis 
XFreePixmap (display, pixmap) 
Display *display; 
Pixmap pixmap; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
pixmap Specifies the pixmap whose ID should be freed. 
Description 


XFreePixmap disassociates a pixmap ID from its resource. If no other client has an ID for 
that resource, it is freed. The Pixmap should never be referenced again by this client. If it is, 
the ID will be unknown and a BadPixmap error will result. 


Errors 
BadPixmap 


Related Commands 
XCreateBitmapFromData, XCreatePixmap, XCreatePixmapFromBitmapData, 
XQueryBestSize, XQueryBestStipple, XQueryBestTile, XReadBitmapFile, 
XSet Tile, XSetWindowBackgroundPixmap, XSetWindowBorderPixmap, 
XWriteBitmapFile. 
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XFreeString List Xlib - Window Manager Hints— 


Name 
XFreeStringList — free the in-memory data associated with the specified string list. 


Synopsis 
void XFreeStringList (list) 
char **list; 


Arguments 
west Specifies the list of strings to be freed. 


Availability 
Release 4 and later. 


Description 
XFreeStringList releases memory allocated by XText PropertyToStringList. 


Related Commands 


XGetTextProperty, XSetTextProperty, XStringListToTextProperty, 
XTextPropertytoStringList. 
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— Xlib —- Graphics Context ————_— XGContextFromGC 


Name 
XGContextFromGC — obtain the GContext (resource ID) associated with the specified 
graphics context. 


Synopsis 
GContext XGContextFromGC (gc) 
GG Cc; 
‘Arguments 
gc Specifies the graphics context of the desired resource ID. 
Description 


XGContextFromGC extracts the resource ID from the GC structure. The GC structure is 
Xlib’s local cache of GC values and contains a field for the GContext ID. This function is 
essentially a macro that accesses this field, since the GC structure is intended to be opaque. 


A GContext is needed to set a field of the XVisuallInfo structure prior to calling xGet- 
VisuallInfo. 


Related Commands 
DefaultGC, XChangeGC, XCopyGC, XCreateGC, XFreeGC, XSetArcMode, XSet- 
Background, XSetClipMask, XSetClipOrigin, XSetClipRectangles, XSet- 
Dashes, XSetFillRule, XSetFillStyle, XSetForeground, XSetFunction, 
XSetGraphicsExposures, XSetLineAttributes, XSetPlaneMask, XSetState, 
XSetStipple, XSet SubwindowMode, XSetTSOrigin. 
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XGeometry Xlib - Standard Geometry — 


Name 


XGeometry — calculate window geometry given user geometry string and default geometry. 


Synopsis 


int XGeometry (display, screen, user_geom, default_geom, bwidth, 
fwidth, fheight, xadder, yadder, x, y, width, height) 
Display *display; 
int screen; 
char *user_geom, *default_geom; 
unsigned int bwidth; 
unsigned int fwidth, fheight; 
int xadder, yadder; 
int *x, *y, *width, *height;/* RETURN */ 


Arguments . 
display Specifies a connection to an X server; returned from XOpenDisplay. 
screen Specifies which screen the window is on. 


user _geom _ Specifies the user or program supplied geometry string, perhaps incomplete. 


default_geom 
Specifies the default geometry string and must be complete. 


bwidth Specifies the border width. 
fheight Specify the font height and width in pixels (increment size). 
fwidth 
xadder Specify additional interior padding in pixels needed in the window. 
yadder 
x Return the user-specified or default coordinates of the window. 
By 
width Return the window dimensions in pixels. 
height 
Description 
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XGeomet ry has been superseded by XWMGeomet ry as of Release 4. 


XGeometry returns the position and size of a window given a user-supplied geometry 
(allowed to be partial) and a default geometry. Each user-supplied specification is copied into 
the appropriate returned argument, unless it is not present, in which case the default specifica- 
tion is used. The default geometry should be complete while the user-supplied one may not be. 


XGeomet ry is useful for processing command line options and user preferences. These geom- 
etry strings are of the form: 


=<width>x<height>({+-}<xoffset>{+-}<yoffset> 
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Xlib — Standard Geometry (continued) XGeometry 


The “=” at the beginning of the string is now optional. (Items enclosed in <> are integers, and 
items enclosed in {} are a set from which one item is to be chosen. Note that the brackets 
should not appear in the actual string.) 


The XGeometry return value is a bitmask that indicates which values were present in 
user _geom. This bitmask is composed of the exclusive OR of the symbols XValue, 
YValue, WidthValue, HeightValue, XNegative, or YNegative. 


_ If the function returns either XValue or YValue, you should place the window at the 
requested position. The border width (bwidth), size of the width and height increments (typi- 
cally fwidth and fheight), and any additional interior space Cradiger and yadder) are 
passed in to make it easy to compute the resulting size. 


Related Commands 
XParseGeometry, XTranslateCoordinates, XWMGeomet ry. 
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XGetAtomName WX lib - Properties— 


Name 
XGetAtomName — get a string name for a property given its atom. 


Synopsis 
char *XGetAtomName (display, atom) 
Display *display; 
Atom atom; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
atom Specifies the atom whose string name you want returned. 

Description 


An atom is a number identifying a property. Properties also have a string name. XGetAtom- 
Name returns the string name that was specified in the original call to XInternAtom that 
returned this atom, or, for predefined atoms, a string version of the symbolic constant without 
the XA_ is returned. If the specified atom is not defined, XGet AtomName returns NULL, and 
generates a BadAt om error. 


For example, XGetAtomName returns "XA_WM_CLASS" (a string) when passed the prede- 
fined atom XA_WM_CLASS (a defined constant). 


You should free the resulting string with XF ree when it is no longer needed. 
XInternAtom performs the inverse function, returning the atom given the string. 


Errors 
BadAtom 


Related Commands 
XChangeProperty, XDeleteProperty, XGetFontProperty, XGetWindow- 
Property, XInternAtom, XListProperties, XRotateWindowProperties, 
XSetStandardProperties. 
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—Xlib — Window Manager Hints XGetClassHint 


Name ’ 
XGetClassHint — get the XA_WM CLASS property of a window. 


Synopsis 
Status XGetClassHint (display, w, class_hints) 
Display *display; 
Window w; 
xXClasshint. *class hints? ,./* RETURN */ 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
w Specifies the ID of the window for which the property. is desired. 


class_hints Returns the XClassHints structure. 


-Description 
XGetClassHint obtains the XA_WM CLASS property for the specified window. This property 
stores the resource class and instance name, that the window manager uses to get any resource 
settings that may control how the window manager manages the application that set this prop- 
erty. XGetClassHint returns a Status of zero on failure, nonzero on success. 


The XClassHint structure returned contains res_class, which is the name of the client 
such as “emacs”, and res_ name, which should be the first of the following that applies: 


° command line option (—rn name) 

° a specific environment variable (e.g., RESOURCE_NAME) 

° the trailing component of argv [0] (after the last /) 

To free res_name and res_class when finished with the strings, use XF ree. 


For more information on using hints, see Volume One, Chapter 10, Jnterclient Communication. 


Structures 
typedef struct { 
char *res name; 
char *res class; 
} KC las shai ¢ 


Errors 
BadWindow 


Related Commands 
XAllocClassHint, XFetchName, XGet IconName, XGet IconSizes, XGetNormal- 
Hints, XGetSizeHints, XGetTransientForHint, XGetWMHints, XGet Zoom- 
Hints, XSetClassHint, XSetCommand, XSet IconName, XSet IconSizes, XSet- 
~ NormalHints, XSetSizeHints, XSetTransientForHint, XSetWMHints, XSet- 
ZoomHints, XStoreName, XSetWMProperties, XSetWMProperties. 
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XGetDefault \———— lib — User Preferences— 


Name 


XGetDefault — extract an option value from the resource database. 


Synopsis 


char *XGetDefault (display, program, option) 
Display *display; 
char *program; 
char *option; 


Arguments 


display Specifies a connection to an X server; returned from XOpenDisplay. 


program Specifies the program name to be looked for in the resource database. The pro- 
gram name is usually argv [ 0], the first argument on the UNIX command line. 


option Specifies the option name or keyword. Lines containing both the program 
name and the option name, separated only by a period or asterisk, will be 
matched. 
Description 
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XGetDefault returns a character string containing the user’s default value for the specified 
programname and option name. XGetDefault returns NULL if no key can be found that 
matches option and program. For a description of the matching rules, see XrmGet- 
Resource. 


The strings returned by XGet Default are owned by Xlib and should not be modified or freed 
by the client. 


Lines in the user’s resource database look like this: 


xterm. foreground: #cOcOff 
xterm.geometry: =81x28 
xterm.saveLines: 256 

xterm. font: 8x13 

xterm. keyMapFile: /usr/black/.keymap 
xterm.activelcon: on 

xmh.header.font 9x15 


The portion on the left is known as a key; the portion on the right is the value. Upper or lower 
case is important in keys. The convention is to capitalize only the second and successive words 
in each option, if any. 


Resource specifications are usually loaded into the XA_RESOURCE_MANAGER property on the 
root window at login. If no such property exists, a resource file in the user’s home directory is 
loaded. On a UNIX-based system, this file is $4OME/.Xdefaults. After loading these defaults, 
XGetDefault merges additional defaults specified by the XENVIRONMENT environment 
variable. If XENVIRONMENT is defined, it contains a full path name for the additional resource 
file. If XENVIRONMENT is not defined, XGetDefault looks for $YHOME/.Xdefaults-name, 
where name specifies the name of the machine on which the application is running. 
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The first invocation of XGet Default reads and merges the various resource files into Xlib so 
that subsequent requests are fast. Therefore, changes to the resource files from the program 
will not be felt until the next invocation of the application. 


For more information, see Volume One, Chapter 11, Managing User Preferences. 


Related Commands 


XAutoRepeatOff, XAutoRepeatOn, XBell, XChangeKeyboardControl, XGet-— 
KeyboardControl, XGetPointerControl. 
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XGetErrorDatabaseText Xlib — Error Handling— 


Name 


XGetErrorDatabaseText — obtain error messages from the error database. 


Synopsis 


XGetErrorDatabaseText (display, name, message, 
default_string, buffer, length) 
Display display; 
char *name, *message; 
char *default_string; 


char *buffer; /* RETURN */ 
int length; 
Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
name Specifies the name of the application. 
message Specifies the type of the error message. One of XProtoError, Xlib- 


Message, or XRequestMa jor (see Description below). 


default_string 
Specifies the default error message. 


buffer Returns the error description. 
length Specifies the size of the return buffer. 
Description 
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XGetErrorDatabaseText returns a message from the error message database. Given 
name and message as keys, XGetErrorDatabaseText uses the resource manager to 
look up a string and returns it in the buffer argument. Xlib uses this function internally to look 
up its error messages. On a UNIX-based system, the error message database is usually 
/usr/lib/X11/XErrorDB. 


The name argument should generally be the name of your application. The message argu- 
ment should indicate which type of error message you want. Three predefined message types 
are used by Xlib to report errors: 


« XProvtobrror 
The protocol error number is used as a string for the message argument. 


e XlibMessage 
These are the message strings that are used internally by Xlib. 


* XRequestMajor 
The major request protocol number is used for the message argument. 


If no string is found in the error database, XGetErrorDatabaseText returns the 
default_string that you specify to the buffer. 


The string in buffer will be of length length. 
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Xlilb — Error Handling (continued) XGetErrorDatabaseText 


For more information, see Volume One, Chapter 3, Basic Window Program. 


Related Commands 
XDisplayName, XGetErrorText, XSetAfterFunction, XSetErrorHandler, 
XSet IOErrorHandler, XSynchronize. 
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XGetErro rText Xlib — Error Handling — 


Name 


XGetErrorText — obtain a description of error code. 


Synopsis 


XGetErrorText (display, code, buffer, length) 
Display *display; 
int code; 
char *buffer; /* RETURN */ 
int length; 


Arguments 
display 


code 

buffer 

length 
Description 


Specifies a connection to an X server; returned from XOpenDisplay. 
Specifies the error code for which you want to obtain a description. 
Returns a pointer to the error description text. 


Specifies the size of the buffer. 


XGetErrorText obtains textual descriptions of errors. XGetErrorText returns a pointer 
to a null-terminated string describing the specified error code with length length. This string 
is copied from static data and therefore may be freed. This routine allows extensions to the 
Xlib library to define their own error codes and error strings that can be accessed easily. 


For more information, see Volume One, Chapter 3, Basic Window Program. 


Related Commands 
XDisplayName, XGetErrorDatabaseText, XSetAfterFunction, XSetError- 
Handler, XSet IOErrorHandler, XSynchronize. 


216 


Xlib Reference Manua! 


—Xlib — Fonts— J XGetFontPath 


Name 
XGetFontPath — get the current font search path. 


Synopsis 
char **XGetFontPath (display, npaths) 
Display *display; 


int *npaths; /* RETURN number of elements */ 
Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
npaths Returns the number of strings in the font path array. 
Description 


XGetFontPath allocates and returns an array of strings containing the search path for fonts. 
The data in the font path should be freed when no longer needed. 


Related Commands 
XCreateFontCursor, XFreeFont, XFreeFontiInfo, XFreeFontNames, XFree- 
FontPath, XGetFontProperty, XListFonts, XListFontswWithInfo, XLoad- 
Font, XLoadQueryFont, XQueryFont, XSetFont, XSetFontPath, XUnloadFont. 
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XGetFontPro pe rty YX ib - Properties — 


Name 
XGetFontProperty — get a font property given its atom. 


Synopsis 
Bool XGetFontProperty(font_struct, atom, value) 
XFontStruct *font_struct; 
Atom atom; 


unsigned long *value; /* RETURN */ 
Arguments 
font_struct Specifies the storage associated with the font. 
atom Specifies the atom associated with the property name you want returned. 
value Returns the value of the font property. 
Description 


XGetFontProperty returns the value of the specified font property, given the atom for that 
property. The function returns False if the atom was not defined, or True if was defined. 


There are a set of predefined atoms for font properties which can be found in <XJ1/Xatom.h>. 
These atoms are listed and described in Volume One, Chapter 6, Drawing Graphics and Text. 
This set contains the standard properties associated with a font. The predefined font properties 
are likely but not guaranteed to be present for any given font. 


See Volume One, Appendix I, Logical Font Description Conventions, for more information on 


font properties. 
Structures 
typedef struct { 
XExtData *ext_data; /* hook for extension to hang data */ 
Font fid; /* Bont. ID fon this font %/ 
unsigned direction; /* hint about direction the font is painted */ 


unsigned min_char or byte2; /* first character */ 
unsigned max _char_or byte2; /* last character */ 


unsigned min_bytel; /* first row that exists */ 

unsigned max _bytel; /* last row that exists */ 

Bool all chars exist; /* flag if all characters have nonzero size*/ 

unsigned default_char; /* char to print for undefined character */ 

int n properties; /* how many properties there are */ 

XFontProp *properties; /* pointer to array of additional properties*/ 

XCharStruct min_bounds; /* minimum bounds over all existing char*/ 

XCharStruct max_bounds; /* minimum bounds over all existing char*/ 

XCharstruct *per char; /* first_char to last char information */ 

int ascent; /* logical extent above baseline for spacing */ 

int descent; /* logical descent below baseline for spacing */ 
} XPontStruct; 


Related Commands 
XChangeProperty, XDeleteProperty, XGetAtomName, XGetWindowProperty, 
XInternAtom, XListProperties, XRotateWindowProperties, XSetStandard- 
Properties. 
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Name 


Synopsis 


Status XGetGCValues (display, 


Display *display; 
GC gc; 


XGetGC Values — obtain components of a given GC from Xlib’s GC cache. 


gc, valuemask, values) 


unsigned long valuemask; 


XGCValues *values; 


/* RETURN */ 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
gc Specifies the GC. 


valuemask Specifies which components in the GC are to be returned in the values 
argument. This argument is the bitwise inclusive OR of one or more of the 
valid GC component mask bits. 


values Returns the GC values in the specified XGCValues structure. 


Availability 
Release 4 and later. 


Description 


XGetGCValues returns the components specified by valuemask for the specified GC. Note 
that the clip mask and dash list (represented by the GCClipMask and GCDashList bits, 
respectively, in the valuemask) cannot be requested. If the valuemask contains a valid set of 
GC mask bits (any of those listed in the Structures section with the exception of GCClipMask 
and GCDashList) and no error occur, XGetGCValues sets the requested components in 
values and retums a nonzero status. Otherwise, it returns a zero status. 


For more information, see Volume One, Chapter 5, The Graphics Context. 


Structures 
typedef struct { 
ink functions 


unsigned long plane_mask; 


unsigned long foreground; 
unsigned long background; 
int line width; 

mnt linerstyle,; 

int cap style; 

int join, style; 

ing cid styles 

init, fa oulles 

int arc_mode; 

Pixmap tile; 

Pixmap stipple; 

int -Gs_x ordgany, 
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/* 
/* 
/* 
/* 
/* 
/* 
/* 
/* 
/* 
/* 
/* 
/* 
/* 
/* 


logical operation */ 

plane mask */ 

foreground pixel */ 

background pixel */ 

line width */ 

LineSolid, LineOnOffDash, LineDoubleDash */ 
CapNotLast, CapButt, CapRound, CapProjecting */ 
JoinMiter, JoinRound, JoinBevel */ 
FillSoltd, FillTiled, FillStippled */ 
EvenOddRule, WindingRule */ 

ArcPieSlice, ArcChord */ 

tile pixmap for tiling operations */ 
stipple 1 plane pixmap for stipping */ 
offset for tile or stipple operations */ 
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int ts y origin; 
Font font; 
int subwindow_mode; 
Bool graphics exposures; 
intael Wouxe origins 
int clip yeorigini; 
Pixmap clip mask; 
int dash_offset; 
char dashes; 
} XGCValues; 


#define GCFunction 
#define GCPlaneMask 
#define GCForeground 
#define GCBackground 
#define GCLineWidth 
#define GCLineStyle 
#define GCCapStyle 
#define GCJoinStyle 
#define GCFillStyle 
#define GCFillRule 
#define GCTile 

#define GCStipple 

#define GCTileStipxXOrigin 
#define GCTileStipYOrigin 
#define GCFont 

#define GCSubwindowMode 
#define GCGraphicsExposures 
#define GCClipXOrigin 
#define GCClipYOrigin 
#define GCClipMask 
#define GCDashOffset 
#define GCDashList 
#define GCArcMode 


Related Commands 
XChangeGC, XCopyGC, XCreateGC. 
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/* 
/* 
/*® 
/* 


/* 
/* 


default text font for text operations */ 
ClipByChildren, IncludeInferiors */ 
generate events on XCopyArea, XCopyPlane */ 
origin for clipping */ 


bitmap clipping; other calls for rects */ 
patterned/dashed line information */ 


(1L<<0) 
(1L<<1) 
(1L<<2) 
(1L<<3) 
(1L<<4) 
(1L<<5) 
(1L<<6) 
(1L<<7) 
(1L<<8) 
(1L<<9) 
(1L<<10) 
(in<<n) 
(1L<<12) 
(1L<<13) 
(1L<<14) 
(aie) 
(l<<1'6) 
(ine<1g) 
(in<<iig) 
(1L<<19) fs not veda am thus: calule/, 
(1L<<20) 
(1b<<27) {* not Valid im this | Galilexy 
(1L<<22) 
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— Xlib — Window Attributes XGetGeometry 


Name ‘ 
XGetGeometry — obtain the current geometry of drawable. 


Synopsis 
Status XGetGeometry (display, drawable, root, xX, y, 
width, height, border_width, depth) 
Display *display; 
Drawable drawable; 


Window *root; /* RETURN */ 

int *x, *y; : /* RETURN */ 

unsigned int *width, *height; /* RETURN */ 

unsigned int *border_width; /* RETURN */ 

unsigned int *depth; /* RETURN */ 
Arguments 


display Specifies a connection to an X server; returned from XOpenDisplay. 


drawable Specifies the drawable, either a window or a pixmap. 


root Returns the root window ID of the specified window. 

x Return the coordinates of the upper-left pixel of the window’s border, relative 
y to its parent’s origin. For pixmaps, these coordinates are always zero. 

width Return the dimensions of the drawable. For a window, these return the inside 
height size (not including the border). 


border_width 
Returns the borderwidth, in pixels, of the window’s border, if the drawable is a 
window. Returns zero if the drawable is a pixmap. 


depth Returns the depth of the pixmap or window (bits per pixel for the object). 
Description 


This function gets the current geometry of a drawable, plus the ID of the root window of the 
screen the window is on. 


XGetGeomet ry returns a Status of zero on failure, or nonzero on success. 


Errors 
BadDrawable 


Related Commands 


XConfigureWindow, XGetWindowAttributes, XMoveResizeWindow, XMove- 
Window, XResizeWindow. 
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Name 
XGetIconName — get the name to be displayed in an icon. 
Synopsis 
Status XGetIconName (display, w, icon_name) 
Display *display; 
Window w; 


char **icon_name; /* RETURN */ 
Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
w Specifies the ID of the window whose icon name you want to learn. 


icon_name Returns a pointer to the name to be displayed in the window’s icon. The 
name should be a null-terminated string. If a name hasn’t been assigned to 
the window, XGet IconName sets this argument to NULL. When finished 
with it, a client must free the icon name string using XF ree. 


Description 
XGet IconName is superseded by XGet WMIconName in Release 4. XGet IconName reads 
the icon name property of a window. This function is primarily used by window managers to 
get the name to be written in a window’s icon when they need to display that icon. 


XGet IconName returns a nonzero Status if it succeeds, and zero if no icon name has been 
set for the argument window. 


For more information, see Volume One, Chapter 10, Interclient Communication. 


Errors 
BadWindow 


Related Commands 
XFetchName, XGetClassHint, XGetIconSizes, XGetNormalHints, XGetSize- 
Hints, XGetTransientForHint, XGetWMHints, XGetZoomHints, XSetClass- 
Hint, XSetCommand, XSet IconName, XSetIconSizes, XSetNormalHints, XSet- 
SizeHints, XSetTransientForHint, XSetWMHints, XSet ZoomHints, XStore- 
Name. 
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— Xlib — Window Manager Hints————“ XGetlconSizes 


Name 
XGetlconSizes — get preferred icon sizes. 


Synopsis 
Status XGetIconSizes (display, w, size_list, count) 
Display *display; 
Window w; 


XIconSize **size list; /* RETURN */ 
int *count; -- /*® RETURN */ 
Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
w Specifies the window ID (usually of the root window). 
size_list Returns a pointer to the size list. 
count Returns the number of items in the size list. 
Description 


XGet IconSizes reads the XA_WM_ICON SIZE property that should be set by the window 
manager to specify its desired icon sizes. XGet IconSizes returns a Status of zero if a 
window manager has not set icon sizes, and a nonzero Status otherwise. This function 
should be called by all programs to find out what icon sizes are preferred by the window man- 
ager. The application should then use XSet WMHints to supply the window manager with an 
icon pixmap or window in one of the supported sizes. To free the data allocated in 
size list, use XFree. 


For more information, see Volume One, Chapter 10, Interclient Communication. 


Structures 
typedef struct { 
int min_width, min_height; 
int max_width, max_height; 
int width_inc, height_inc; 
} XIconSize; 


/* width_inc and height_inc provide the preferred 
* increment of sizes in the range from min_width 


* to max_width and min_height to max_height. */ 


Errors 
BadWindow 
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Related Commands 
XAllocIconSize, XFetchName, XGetClassHint, XGetIconName, XGetNormal- 
Hints, XGetSizeHints, XGetTransientForHint, XGetWMHints, XGetZoom- 
Hints, XSetClassHint, XSetCommand, XSetIconSizes, XSetNormalHints, 
XSetSizeHints, XSetTransientForHint, XSetWMHints, XSetZoomHints, 
XStoreName. 
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—Xlib — Images XGetimage 


Name 
XGetImage — place contents of a rectangle from drawable into an image. 


Synopsis 
XImage *XGetImage (display, drawable, x, y, width, height, 
Plane_mask, format) 
Display *display; 
Drawable drawable; 
BVT en Vr 
unsigned int width, height; 
unsigned long plane_mask; 
int format; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 


drawable Specifies the drawable to get the data from. 


x Specify the x and y coordinates of the upper-left corner of the rectangle, rela- 

y tive to the origin of the drawable. 

width Specify the width and height in pixels of the image. 

height 

plane _mask Specifies a plane mask that indicates which planes are represented in the 
image. 

format Specifies the format for the image. Pass either XYPixmap or ZPixmap. 


Description 
XGet Image dumps the contents of the specified rectangle, a drawable, into a client-side XIm- 
age structure, in the format you specify. Depending on which format you pass to the format 
arguinent, the function does the following: 


° If the format is XYPixmap 
Gets only the bit planes you passed to the plane_mask argument. 
° If the format is ZPixmap 


Sets to 0 the bits in all planes not specified in the plane_mask argument. The function 
performs no range checking on the values in plane_mask, and ignores extraneous bits. 


XGet Image returns the depth of the image to the depth member of the XImage structure. 
This depth is as specified when the drawable was created. 


If the drawable is a pixmap, the specified rectangle must be completely inside the pixmap, or a 

BadMatch error will occur, and the visual field in the image will be None. If XGet Image 

fails, it returns NULL. If the drawable is a window, the window must be viewable, and the speci- 

fied rectangle must not go off the edge of the screen. Otherwise, a BadMat ch error will occur. 

If the drawable is a window, the visual argument will return the visual specified when the 
drawable was created. 
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The returned image will include any visible portions of inferiors or overlapping windows con- 
tained in the rectangle. The image will not include the cursor. The specified area can include 
the borders. The returned contents of visible regions of inferiors of different depth than the 
specified window are undefined. 


If the window has a backing-store, the backing-store contents are returned for regions of the 
window that are obscured by noninferior windows. Otherwise, the return contents of such 
obscured regions are undefined. Also undefined are the returned contents of visible regions of 
inferiors of different depth than the specified window. 


The data in the image structure is stored in the server’s natural byte- and bit-order. 
For more information, see Volume One, Chapter 6, Drawing Graphics and Text. 
Errors 
BadDrawable 
BadMatch See Description above. 
BadValue 
Related Commands 


ImageByteOrder, XAddPixel, XCreateImage, XDestroyImage, XGetPixel, 
XGetSubImage, XPut Image, XPutPixel, XSubImage. 
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— Xlib — Input Handling XGetinputFocus 


Name 
XGetInputFocus — return the current keyboard focus window. 


Synopsis 
XGetInputFocus (display, focus, revert_to) 
Display *display; 
Window *focus; /* RETURN */ 
int *revert_to; fe RETURN. #7 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 


focus Returns the ID of the focus window, or one of the constants PointerRoot 
or None. 


revert_to _ Returns the window to which the focus would revert if the focus window 
became invisible. This is one of these constants: RevertToParent, 
RevertToPointerRoot, or RevertToNone. Must not be a window ID. 


Description 
XGet InputFocus returns the current keyboard focus window and the window to which the 
focus would revert if the focus window became invisible. 


XGetInputFocus does not report the last focus change time. This is available only from 
FocusIn and FocusOut events. 


Related Commands 
QLength, XAllowEvents, XCheckIfEvent, XCheckMaskEvent, XCheckTyped- 
Event, XCheckTypedWindowEvent, XCheckWindowEvent, XEventsQueued, 
XGetMotionEvents, XIfEvent, XMaskEvent, XNextEvent, XPeekEvent, XPeek- 
IfEvent, XPending, XPutBackEvent, XSelect Input, XSendEvent, XSet Input- 
Focus, XSynchronize, XWindowEvent. 
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XGetKeyboardControl \.——————- X lib — User Preferences— 


Name 
XGetKeyboardControl — obtain a list of the current keyboard preferences. 


Synopsis 
XGetKeyboardControl (display, values) 
Display *display; 
XKeyboardState *values; /* RETURN */ 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
values Returns filled XKeyboardState structure. 

Description 


XGetKeyboardControl returns the current control values for the keyboard. For the LEDs 
(light emitting diodes), the least significant bit of 1ed_mask corresponds to LED 1, and each 
bit that is set to 1 in 1ed_mask indicates an LED that is lit. auto_repeats is a bit vector; 
each bit that is set to 1 indicates that auto-repeat is enabled for the corresponding key. The vec- 
tor is represented as 32 bytes. Byte N (from 0) contains the bits for keys 8N to 8N+7, with the 
least significant bit in the byte representing key 8N. global_auto_repeat is either 
AutoRepeatModeOn or AutoRepeatModeOff. 


For the ranges of each member of XKeyboardState, see the description of XChange- 
PointerControl. 


For more information, see Volume One, Chapter 9, The Keyboard and Pointer. 


Structures 

typedef struct { 
int key click percent; 
impebel percents, 
unsigned int bell pitch, bell duration; 
unsigned long led mask; 
int global auto repeat; 
char auto_repeats[32]; 

} XKeyboardState; 


Related Commands 


XAutoRepeatOff, XAutoRepeatoOn, XBell, XChangeKeyboardControl, XGet- 
Default, XGetPointerControl. 
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- qb Keyboard ) XGetKeyboardMapping 


Name 
XGetKeyboardMapping — return symbols for keycodes. 


Synopsis 
KeySym *XGetKeyboardMapping(display, first_keycode, 
keycode_count, keysyms_per_keycode) 
Display *display; 
KeyCode first_keycode; 
int keycode_count; 
int *keysyms_per_ keycode; /* RETURN */ 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 


first_keycode 
Specifies the first keycode that is to be returned. 


keycode_count 
Specifies the number of keycodes that are to be returned. 


keysyms_per_ keycode 
Returns the number of keysyms per keycode. 


Description 
Starting with first_keycode, XGetKeyboardMapping returns the symbols for the 
specified number of keycodes. The specified first _keycode must be greater than or equal 
to min_keycode as returned by XDisplayKeycodes, otherwise a BadValue error 
occurs. In addition, the following expression must be less than or equal to max_keycode 
(also returned by XDisplayKeycodes) as returned in the Display structure, otherwise a 
BadValue error occurs: 


ELESe ake yiCOde tT KeyCOdeeCOUNIt el: 
The number of elements in the keysyms list is: 
keycode _count * keysyms per keycode 


Then, keysym number N (counting from 0) for keycode K has an index (counting from 0) of the 
following (in keysyms): 


(Ke meermesia keycode) * keysyms per keycode +N 


The keysyms_per_ keycode value is chosen arbitrarily by the server to be large enough to 
report all requested symbols. A special KeySym value of NoSymbo1 is used to fill in unused 
elements for individual keycodes. 


Use XF ree to free the returned keysym list when you no longer need it. 


For more information, see Volume One, Chapter 9, The Keyboard and Pointer. 
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Errors 
BadValue first_keycode less than display->min_keycode. 


display->max_keycode exceeded. 


Related Commands 
XChangeKeyboardMapping, XDeleteModifiermapEntry, XFreeModifiermap, 
XGetModifierMapping, XInsertModifiermapEntry, XKeycodeToKeysym, 
XKeysymToKeycode, XKeysymToString, XLookupKeysym, XLookupString, 
XNewModifierMap, XQueryKeymap, XRebindKeySym, XRef reshKeyboard- 
Mapping, XSetModifierMapping, XStringToKeysym. 
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—X Programming Library ——————” XGetModifierMapping 


Name 
XGetModifierMapping — obtain a mapping of modifier keys (Shift, Control, etc.). 


Synopsis 
XModifierKeymap *XGetModifierMapping (display) 
Display *display; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 


Description z 
XGetModifierMapping returns the keycodes of the keys being used as modifiers. 


There are eight modifiers, represented by the symbols ShiftMapIndex, LockMapIndex, 
ControlMapIndex, Mod1MapIndex, Mod2MapIndex, Mod3MapIndex, Mod4Map- 
Index, and Mod5MapIndex. The modifiermap member of the XModifierKeymap 
structure contains eight sets of keycodes, each set containing max_keypermod keycodes. 
Zero keycodes are not meaningful. If an entire modifiermap is filled with zero’s, the corre- 
sponding modifier is disabled. No keycode will appear twice anywhere in the map. 


Structures 
typedef struct { 
int max_keypermod; /* server's max number of keys per modifier */ 
KeyCode *modifiermap; /* an 8 by max_keypermod array of 
* keycodes to be used as modifiers */ 
} XModifierKeymap; 


/* modifier names. Used to build a SetModifierMapping request or 
to read a GetModifierMapping request. */ 

#define ShiftMapIndex 0 

#define LockMapIndex 
#define ControlMapIndex 
#define Mod1lMapIndex 
#define Mod2MapIndex 
#define Mod3MapIndex 
#define Mod4MapIndex 
#define Mod5MapIndex 


NOOB WNP 


Related Commands 
XChangeKevboardMapping, XDeleteModifiermapEntry, XFreeModifiermap, 
XGetKeyboardMapping, XInsertModifiermapEntry, XKeycodeToKeysym, 
XKeysymToKeycode, XKeysymToString, XLookupKeysym, XLookupString, 
XNewModifierMap, XQueryKeymap, XRebindKeySym, XRefreshKeyboard- 
Mapping, XSetModifierMapping, XStringToKeysym. 
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XGetMotionEvents \ Xlib~inputHandiing= 


Name 
XGetMotionEvents — get events from pointer motion history buffer. 


Synopsis 
XTimeCoord *XGetMotionEvents (display, w, start, stop, nevents) 
Display *display; 
Window w; 
Time start, stop; 


int *nevents; /* RETURN */ 

Arguments 

display Specifies a connection to an X server; returned from XOpenDisplay. 

w Specifies the ID of the window whose associated pointer motion events will be 

returned. 

start Specify the time interval for which the events are returned from the motion his- 

stop tory buffer. Pass a time stamp (in milliseconds) or Current Time. 

nevents Returns the number of events returned from the motion history buffer. 
Description 


XGetMotionEvents returns all events in the motion history buffer that fall between the 
specified start and stop times (inclusive) and that have coordinates that lie within (including 
borders) the specified window at its present placement. The x and y coordinates of the 
XTimeCoord return structure are reported relative to the origin of w. 


XGetMotionEvent returns NULL if the server does not support a motion history buffer 
(which is common), or if the start time is after the stop time, or if the start time is in the future. 
A motion history buffer is supported if XDisplayMotionBufferSize (display) > 0. The 
pointer position at each pointer hardware interrupt is then stored for later retrieval. 


If the start time is later than the stop time, or if the start time is in the future, no events are 
returned. If the stop time is in the future, it is equivalent to specifying the constant Current- 
Time, since the server does not wait to report future events. 


Use xF ree to free the returned XTimeCoord structures when they are no longer needed. 
For more information, see Volume One, Chapter 9, The Keyboard and Pointer. 
Structures 
typedef struct XTimeCoord { 
Time time; 


SHO Page y7 
} XTimeCoord; 


Errors 
BadWindow 
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Related Commands 
QLength, XAllowEvents, XCheckIfEvent, XCheckMaskEvent, XCheckTyped- 
Event, XCheckTypedWindowEvent, XCheckWindowEvent, XEventsQueued, 
XGet InputFocus, XilfEvent, XMaskEvent, XNextEvent, XPeekEvent, XPeek- 
IfEvent, XPending, XPutBackEvent, XSelect Input, XSendEvent, XSet Input- 
Focus, XSynchronize, XWindowEvent. 
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XGetNormalHints \—— Xlib — Window Manager Hints — 


Name 
XGetNormalHints — get the size hints property of a window in normal state (not zoomed or 
iconified). 
Synopsis 


Status XGetNormalHints (display, w, hints) 
Display *display; 
Window w; 


XSizeHints *hints; /* RETURN */ 
Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
w Specifies the ID of the window to be queried. 
hints Returns the sizing hints for the window in its normal state. 
Description 


XGetNormalHints has been superseded by XGetWMNormalHints as of Release 4, 
because new interclient communication conventions are now standard. 


XGetNormalHints returns the size hints for a window in its normal state by reading the 
XA_WM NORMAL HINTS property. This function is normally used only by a window manager. It 
returns a nonzero Status if it succeeds, and zero if it fails (e.g., the application specified no 
normal size hints for this window.). 


For more information on using hints, see Volume One, Chapter 10, Interclient Communication. 


Structures 
typedef struct { 

long flags; /* which fields in structure are defined */ 
enix Vp 
int width, height; 
int min width, min height; 
int max width, max_height; 
IMieeWw Le henC;neughinn Inc, 


SEGLUCE. { 
amie exe /* numerator */ 
nig Was /* denominator */ 


} min aspect, max_aspect; 
} XSizeHints; 


/* flags argument in size hints */ 
#define USPosition (1L << 0)/* user specified x, y */ 





#define USSize (1L << 1)/* user specified width, height */ 
#define PPosition (1L << 2)/* program specified position */ 
#define PSize (1, << 3)/* program specified size */ 

#define PMinSize (1L << 4)/* program specified minimum size */ 
#define PMaxSize (1L << 5)/* program specified maximum size */ 
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#define PResizelInc 
#define PAspect 
#define PAllHints 


(1L << 6)/* program specified resize increments */ 
(1L << 7)/* program specified min/max aspect ratios */ 
(PPosition|PSize|PMinSize|PMaxSize|PResizelInc|PAspect) 


Errors 
BadWindow 


Related Commands 


XFetchName, XGetClassHint, XGetIconName, XGetIconSizes, XGetSize- 
Hints, XGetTransientForHint, XGetWMHints, XGet ZoomHints, XSetClass- 
Hint, XSetCommand, XSet IconName, XSetIconSizes, XSetNormalHints, XSet- 


SizeHints, XSetTransientForHint, XSetWMHints, XSetZoomHints, XStore- 
Name. 
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XGetPixel \ Kiib wimages 


Name 
XGetPixel — obtain a single pixel value from an image. 


Synopsis 
unsigned long XGetPixel (ximage, x, y) 
XImage *ximage; 


Ena tear 
Davee Van 
Arguments 
ximage Specifies a pointer to the image. 
2 Specify the x and y coordinates of the pixel whose value is to be returned. 
v7 
Description 


XGetPixel returns the specified pixel from the named image. The x and y coordinates are 
relative to the origin (upper left [0,0]) of the image). The pixel value is returned in the clients 
bit- and byte-order. The x and y coordinates must be contained in the image. 


For more information, see Volume One, Chapter 6, Drawing Graphics and Text. 


Structures 
typedef struct XImage { 
int width, height; /* size of image */ 
int xoffset; /* number of pixels offset in X direction */ 
int format; /* XYBitmap, XYPixmap, ZPixmap */ 
char *data; /* pointer to image data */ 
int byte order; /* data byte order, LSBFirst, MSBFirst */ 
int bitmap_unit; [quant = Of scan lame moja iGmse ax, 
int bitmap bit order; /* LSBFirst, MSBFirst */ 
int bitmap pad; (x87 UG, 32 elther XYeorm Zeixmap + / 
Pate Ce Ot lu; /* depth of image */ 
ais, lyAsSs) josie Ihalae7 /* accelerator to next line */ 
able, losiiet) jorea jonly.<auly /* bits per pixel (ZPixmap) */ 
unsigned long red_mask; /* bits in z arrangment */ 


unsigned long green_mask; 
unsigned long blue_mask; 


char *obdata; /* hook for the object routines to hang on */ 
struct funcs { /* image manipulation routines */ 

struct XImage *(*create image) (); 

int (*destroy_ image) (); 

unsigned long (*get_ pixel) (); 


inc (pute pulse!) (}'; 
struct XImage *(*sub_ image) (); 
Tie (A ACOmpuXe Ih) N ip 
bette 
} XImage; 
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Related Commands 
ImageByteOrder, XAddPixel, XCreateIntage, XDestroyImage, XGet Image, 
XGet SubImage, XPut Image, XPutPixel, XSubImage. 
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Name 
XGetPointerControl — get the current pointer preferences. 
Synopsis 
XGetPointerControl (display, accel_numerator, accel_denominator, 
threshold) 
Display *display; 
int *accel_ numerator, *accel_denominator; /* RETURN */ 
int *threshold; /* RETURN */ 
Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 


accel_numerator 
Returns the numerator for the acceleration multiplier. 


accel_denominator 
Returns the denominator for the acceleration multiplier. 


threshold _ Returns the acceleration threshold in pixels. The pointer must move more 
than this amount before acceleration takes effect. 


Description 
XGetPointerControl gets the pointer acceleration parameters. 


accel_numerator divided by accel_denominator is the number of pixels the cursor 


moves per unit of motion of the pointer, applied only to the amount of movement over 
threshold. 


Related Commands 
XChangeActivePointerGrab, XChangePointerControl, XGetPointer- 


Mapping, XGrabPointer, XQueryPointer, XSetPointerMapping, XUngrab- 
Pointer, XWarpPointer. 
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Name ; 
XGetPointerMapping — get the pointer button mapping. 


Synopsis 
int XGetPointerMapping (display, map, nmap) 
Display *display; 
unsigned char map[]; /* RETURN */ 
int nmap; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
map Returns the mapping list. Array begins with map []. 
nmap Specifies the number of items in mapping list. 

Description 


XGetPointerMapping returns the current mapping of the pointer buttons. Information is 
returned in both the arguments and the function’s return value. map is an array of the numbers 
of the buttons as they are currently mapped. Elements of the list are indexed starting from 1. 
The nominal mapping for a pointer is the identity mapping: map[i]=i. If map[3]=2, it 
means that the third physical button triggers the second logical button. 


nmap indicates the desired number of button mappings. 
The return value of the function is the actual number of elements in the pointer list, which may 
be greater or less than nmap. 


Related Commands 
XChangeActivePointerGrab, XChangePointerControl, XGetPointer- 
Control, XGrabPointer, XQueryPointer, XSetPointerMapping, XUngrab- 
Pointer, XWarpPointer. 
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Name 
XGetRGBColormaps — obtain the XSt andardColormap structure associated with the 
specified property. 
Synopsis % 
Status XGetRGBColormaps (display, w, std_colormap, count, 
property) 
Display *display; 
Window w; 
XStandardColormap **std_colormap; /* RETURN */ 
ant *coune ; /* RETURN */ 
Atom property; 
Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
Ww Specifies the window. 


std_colormap 
Returns the XSt andardColormap Structure. 


count Returns the number of colormaps. 
property Specifies the property name. 
Availability 


Release 4 and later. 


Description 

XGetRGBColormaps returns the RGB colormap definitions stored in the specified property 
on the named window. If the property exists, is of type RGB_COLOR MAP, is of format 32, and is 
long enough to contain a colormap definition, XGet RGBColormaps allocates and fills in 
space for the returned colormaps, and returns a non-zero status. Otherwise, none of the fields 
are set, and XGetRGBColormaps returns a zero status. If the visualid field is not present, 
XGetRGBColormaps assumes the default visual for the screen on which the window is 
located; if the killid field is not present, it is assumed to have a value of None, which indicates 
that the resources cannot be released. Note that it is the caller’s responsibility to honor the 
ICCCM restriction that only RGB_DEFAULT_ MAP contain more than one definition. 


XGetRGBColormaps supersedes XGet StandardColormap. 


For more information, see Volume One, Chapter 7, Color. 


Structures 
typedef struct { 
Colormap colormap; 
unsigned long red _ max; 
unsigned long red mult; 
unsigned long green _max; 


240 Xlib Reference Manual 


Xlib — Window Manager Hints (continued) XGetRGBColormaps 


unsigned long green mult; 
unsigned long blue max; — ' 
unsigned long blue _ mult; 
unsigned long base pixel; 


VisualID visualid; /* added by ICCCM version 1 */ 
XMEDriaa ae /* added by ICCCM version 1 */ 
} XStandardColormap; 
- Errors 
BadAtom 
BadWindow 


Related Commands 
XAllocStandardColormap, XSetRGBColormaps. 
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Name 
XGetScreenSaver — get the current screen saver parameters. 


Synopsis 
XGet ScreenSaver (display, timeout, interval, prefer blanking, 
allow_exposures) 
Display *display; 


int *timeout, *interval; /* RETURN */ 
int *prefer blanking; /* RETURN */ 
int *allow_exposures; /* RETURN */ 
Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
timeout Returns the idle time, in seconds, until the screen saver turns on. 
interval Returns the interval between screen changes, in seconds. 


prefer_blanking 
Returns the current screen blanking preference, one of these constants: 
DontPreferBlanking, PreferBlanking, or DefaultBlanking. 


allow_exposures 
Returns the current screen save control value, either DontAllow- 
Exposures, AllowExposures, or DefaultExposures. 


Description 
XGet ScreenSaver retums the current settings of the screen saver, which may be set with 
XSetScreenSaver. 


A positive timeout indicates that the screen saver is enabled. A timeout of zero indicates 
that the screen saver is disabled. 


If the server-dependent screen saver method supports periodic change, interval serves as a 
hint about the length of the change period, and zero serves as a hint that no periodic change 
will be made. An interval of zero indicates that random pattern motion is disabled. 


For more information on the screen saver, see Volume One, Chapter 13, Other Programming 
Techniques. 


Related Commands 
XActivateScreenSaver, XForceScreenSaver, XResetScreenSaver, XSet- 
ScreenSaver. 
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Name : 
XGetSelectionOwner — return the owner of a seléction. 
Synopsis 
Window XGetSelectionOwner (display, selection) 
Display *display; 
Atom selection; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
selection Specifies the selection atom whose owner you want returned. 

Description 
XGetSelectionOwner returns the window ID of the current owner of the specified selec- 
tion. If no selection was specified, or there is no owner, the function returns the constant None. 


For more information on selections, see Volume One, Chapter 10, Interclient Communication. 


Errors 
BadAtom 


Related Commands 
XConvertSelection, XSetSelectionOwner. 
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Name 
XGetSizeHints — read any property of type XA_SIZE_HINTS. 


Synopsis 
Status XGetSizeHints (display, w, hints, property) 
Display *display; 
Window w; 
XSizeHints *hints; /* RETURN */ 
Atom property; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
w Specifies the ID of the window for which size hints will be returned. 
hints Returns the size hints structure. 


property Specifies a property atom of type XA_WM SIZE HINTS. May be 
XA_WM NORMAL HINTS, XA_WM Z00M HINTS (in Release 3), or a property 
defined by an application. 


Description 
XGetSizeHints has been superseded by XGet WMSizeHints as of Release 4, because the 
interclient communication conventions are now standard. 


XGetSizeHints returns the XSizeHints structure for the named property and the speci- 
fied window. This is used by XGetNormalHints and XGet ZoomHints, and can be used to 
retrieve the value of any property of type XA_WM_SIZE_HINTS; thus, it is useful if other proper- 
ties of that type get defined. This function is used almost exclusively by window managers. 


XGetSizeHints returns a nonzero Status if a size hint was defined, and zero otherwise. 


For more information on using hints, see Volume One, Chapter 10, Jnterclient Communication. 


Structures 
typedef struct { 

long flags; /* which fields in structure are defined */ 
Tartu mV Es 
int width, height; 
int min_width, min_height; 
int max width, max_height; 
int width_inc, height_inc; 


Seruct 4 
int x; /* numerator */ 
ane y 2 /* denominator */ 


} min_aspect, max_aspect; 
} XSizeHints; 


/* flags argument in size hints */ 


#define USPosition (1L << 0) /* user specified x, y */ 
#define USSize (1L << 1) /* user specified width, height */ 
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#define PPosition 
#define PSize 
#define PMinSize 
#define PMaxSize 
#define PResizelInc 
#define PAspect 
#define PAllHints 


Errors 
BadAtom 
BadWindow 


Related Commands 
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<< 
<< 
<< 
<< 
<< 


2) 
3) 
4) 
©) 
6) 
7) 


(continued) 


/* 
ie 
/* 
/* 
/* 
/* 


program 
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specified 


XGetSizeHints 


POswedon *// 

size */ 

minimum size */ 

maximum size */ 

resize increments */ 
min/max aspect ratios */ 


(PPosition|PSize|PMinSize|PMaxSize|PResizelInc|PAspect) 


XFetchName, XGetClassHint, XGetIconName, XGetIconSizes, XGetNormal- 
Hints, XGetTransientForHint, XGetWMHints, XGetZoomHints, XSetClass- 
Hint, XSetCommand, XSetIconName, XSetIconSizes, XSetNormalHints, XSet- 
SizeHints, XSetTransientForHint, XSetWMHints, XSet ZoomHints, XStore- 


Name. 
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Name 


XGetStandardColormap — get the standard colormap property. 


Synopsis 


Status XGetStandardColormap(display, w, cmap_info, property) 
Display *display; 
Window w; 
XStandardColormap *cmap_info;/* RETURN */ 
Atom property; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
Ww Specifies the ID of the window on which the property is set. This is normally 


the root window. 
cmap_info Returns the filled colormap information structure. 


property Specifies the atom indicating the type of standard colormap desired. The 
predefined standard colormap atoms are XA _RGB BEST MAP, 
XA_RGB_RED MAP, XA_RGB_ GREEN MAP, XA_RGB BLUE MAP, 
XA_RGB DEFAULT MAP, and XA_RGB_GRAY MAP. 


Description 
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XGet StandardColormap is superseded by XGet WMColormap in Release 4. 


XGetStandardColormap gets a property on the root window that describes a standard 
colormap. 


This call does not install the colormap into the hardware colormap, it does not allocate entries, 
and it does not even create a virtual colormap. It just provides information about one design of 
colormap and the ID of the colormap if some other client has already created it. The applica- 
tion can otherwise attempt to create a virtual colormap of the appropriate type, and allocate its 
entries according to the information in the XStandardColormap structure. Installing the 
colormap must then be done with XInstallColormap, in cooperation with the window 
manager. Any of these steps could fail, and the application should be prepared. 


If the server or another client has already created a standard colormap of this type, then its ID 
will be returned in the colormap member of the XStandardColormap structure. Some 
servers and window managers, particular on high-performance workstations, will create some 
or all of the standard colormaps so they can be quickly installed when needed by applications. 


An application should go through the standard colormap creation process only if it needs the 
special qualities of the standard colormaps. For one, they allow the application to convert RGB 
values into pixel values quickly because the mapping is predictable. Given an XStandard- 
Colormap structure for an XA_RGB_BEST MAP colormap, and floating point RGB coefficients 
in the range 0.0 to 1.0, you can compose pixel values with the following C expression: 
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pixel = base pixel 
tuat(unesdgnedidong). (0.5 oturi*.ned.max)),.* ced ,mult 
+.((ansigned long) (0.5 + g.* green_max)) * green mult 
+.(Ciunsioned Jong) .(0.5 +.b,* blue max)) * blue mult; 


The use of addition rather than logical-OR for composing pixel values permits allocations 
where the RGB value is not aligned to bit boundaries. 


XGet StandardColormap returns zero if it fails, or nonzero if it succeeds. 


See Volume One, Chapter 7, Color, for a complete description of standard colormaps. 


Structures 

typedef struct { 
Colormap colormap; /* ID of colormap created by XCreateColormap */ 
unsigned long red_max; 
unsigned long red mult; 
unsigned long green _max; 
unsigned long green_mult; 
unsigned long blue _max; 
unsigned long blue mult; 
unsigned long base pixel; 
/* new fields here in R4 */ 

} XStandardColormap,; 


Errors 
BadAtom 
BadWindow 


Related Commands 
DefaultColormap, DisplayCells, XCopyColormapAndF ree, XCreate- 
Colormap, XFreeColormap, XInstallColormap, XListInstalledColormaps, 
XSetStandardColormap, XSetWindowColormap, XUninstallColormap. 
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Name 
XGetSubImage — copy a rectangle in drawable to a location within the pre-existing image. 


Synopsis 
XImage *XGetSubImage (display, drawable, xX, Yr width, height, 
plane_mask, format, dest_image, dest_x, dest_y) 
Display *display; 
Drawable drawable; 
inex; Wy? 
unsigned int width, height; 
unsigned long plane_mask; 
aligie, seepage 
XImage *dest_image; 
int destix;r dest y; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
drawable Specifies the drawable from which the rectangle is to be copied. 
x Specify the x and y coordinates of the upper-left corner of the rectangle, rela- 
y tive to the origin of the drawable. 
width Specify the width and height in pixels of the subimage taken. 
height 


pl an e mask Specifies which planes of the drawable are transferred to the image. 
format Specifies the format for the image. Either XYPixmap or ZPixmap. 


dest_image Specifies the the destination image. 


dest_x Specify the x and y coordinates of the destination rectangle’s upper left cor- 
dest_y ner, relative to the image’s origin. 
Description 


XGet SubImage updates the dest_image with the specified subimage in the same manner 
as XGet Image, except that it does not create the image or necessarily fill the entire image. If 
format is XYPixmap, the function transmits only the bit planes you specify in 
plane_mask. If format is ZPixmap, the function transmits as zero the bits in all planes 
not specified in plane_mask. The function performs no range checking on the values in 
plane_mask and ignores extraneous bits. 


The depth of the destination XImage structure must be the same as that of the drawable. 
Otherwise, a BadMat ch error is generated. If the specified subimage does not fit at the speci- 
fied location on the destination image, the right and bottom edges are clipped. If the drawable 
is a window, the window must be mapped or held in backing store, and it must be the case that, 
if there were no inferiors or overlapping windows, the specified rectangle of the window would 
be fully visible on the screen. Otherwise, a BadMat ch error is generated. 
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If the window has a backing store, the backing store contents are returned for regions of the 
window that are obscured by noninferior windows. Otherwise, the return contents of such 
obscured regions are undefined. Also undefined are the returned contents of visible regions of 
inferiors of different depth than the specified window. 


XSubImage extracts a subimage from an image, instead of from a drawable like XGet Sub- 
Image. 


For more information on images, see Volume One, Chapter 6, Drawing Graphics and Text. 
Errors 
BadDrawable 
BadMatch Depth of dest_image is not the same as depth of drawable. 
BadValue ! 
Related Commands 


ImageByteOrder, XAddPixel, XCreateImage, XDest royImage, XGet Image, 
XGetPixel, XPut Image, XPutPixel, XSubImage. 
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Name 
XGetTextProperty — read one of a window’s text properties. 


Synopsis 
Status XGetTextProperty (display, w, text_prop, property) 
Display *display; 
Window w; 
XTextProperty *text_prop; /* RETURN */ 
Atom property; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
w Specifies the window. 


text_prop Returns the XText Property Structure. 
property Specifies the property name. 


Availability 
Release 4 and later. 


Description 

XGet TextProperty reads the specified property from the window and stores the data in the 
returned XTextProperty structure. It stores the data in the value field, the type of the data 
in the encoding field, the format of the data in the format field, and the number of items of 
data in the nitems field. The particular interpretation of the property’s encoding and data as 
‘text’ is left to the calling application. If the specified property does not exist on the window, 
XGetTextProperty sets the value field to NULL, the encoding field to None, the format 
field to zero, and the nitems field to zero. 


If it was able to set these files in the XTextProperty structure, XGet TextProperty 
returns a non-zero status; otherwise, it returns a zero status. 


For more information, see Volume One, Chapter 10, Jnterclient Communication. 


Structures 
typeder Struck, { 
unsigned char *value; /* same as Property routines */ 
Atom encoding; /* prop type */ 
int format; /* prop data fLormate 8, Lop Or een 
unsigned long nitems; /* number of data items in value */ 
} XTextProperty; 


Errors 
BadAtom 
BadWindow 
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Related Commands 
XFreeStringList, XSetTextProperty, XStringListToTextProperty, XText- 
PropertytoStringList. 
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Name 
XGetTransientForHint — get the XA_WM TRANSIENT FOR property of a window. 


Synopsis 
Status XGetTransientForHint (display, w, prop window) 
Display *display; 
Window w; 


Window *prop_ window; /* RETURN */ 
Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
Ww Specifies the ID of the window to be queried. 


prop window Returns the window contained in the XA_WM_TRANSIENT_FOR property of the 
specified window. 


Description 
XGetTransientForHint obtains the XA_WM TRANSIENT FOR property for the specified 
window. This function is normally used by a window manager. This property should be set for 
windows that are to appear only temporarily on the screen, such as pop-up dialog boxes. The » 
window returned is the main window to which this popup window is related. This lets the win- 
dow manager decorate the popup window appropriately. 


XGetTransientForHint retums a Status of zero on failure, and nonzero on success. 
For more information on using hints, see Volume One, Chapter 10, Jnterclient Communication. 


Errors 
BadWindow 


Related Commands 
XFetchName, XGetClassHint, XGet IconName, XGet IconSizes, XGetNormal- 
Hints, XGetSizeHints, XGetWMHints, XGetZoomHints, XSetClassHint, XSet- 
Command, XSet IconName, XSetIconSizes, XSetNormalHints, XSetSizeHints, 
XSetTransientForHint, XSetWMHints, XSetZoomHints, XStoreName. 
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Name 
XGetVisualInfo — find the visual information structures that match the specified template. 


Synopsis 
XVisualiInfo *XGetVisualInfo (display, vinfo_mask, 
vinfo_ template, nitems) 
Display *display; 
long vinfo_mask; 
XVisualiInfo *vinfo_ template; 


int *nitems; -{* RETURN */ 
Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 


vinfo_mask Specifies the visual mask value. Indicates which elements in template are to 
be matched. 


vinfo_ template 
Specifies the visual attributes that are to be used in matching the visual struc- 
tures. 


nitems Returns the number of matching visual structures. 


Description 
XGetVisualiInfo returns a list of visual structures that describe visuals supported by the 
server and that match the attributes specified by the vinfo_template argument. If no 
visual structures match the template, XGetVisualInfo returns a NULL. To free the data 
returned by this function, use XF ree. 


For more information, see Volume One, Chapter 7, Color. 


Structures 

typedef struct { 
Visual *visual; 
VisualID visualid; 
int screen; 
unsigned int depth; 
Laiwelass; : 
unsigned long red_mask; 
unsigned long green mask; 
unsigned long blue mask; 
int colormap size; 
sini ORne SMO eiaget by 

} XVisuallInfo; 


/* The symbols for the vinfo_mask argument are: */ 


#define VisualNoMask Ox0 
-#define VisualIDMask Oxl 
#define VisualScreenMask Ox2 
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#define VisualDepthMask Ox4 

#define VisualClassMask 0x8 

#define VisualRedMaskMask 0x10 
#define VisualGreenMaskMask 0x20 
#define VisualBlueMaskMask 0x40 
#define VisualColormapSizeMask 0x80 
#define VisualBitsPerRGBMask 0x100 
#define VisualAl1lMask Ox1FF 


Related Commands 
DefaultVisual, XVisualIDFromVisual, XMatchVisualiInfo, XListDepths. 
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Name 
XGetWMlIconName — read a window’s XA_WM_ ICON NAME property. 


Synopsis 
Status XGetWMIconName (display, w, text_prop) 
Display *display; 
Window w; 
XTextProperty *text_prop;/* RETURN */ 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
w Specifies the window. 


text_prop Returns the XText Property Structure. 


Availability 
Release 4 and later. 


Description 
XGetWMIconName performs an XGetTextProperty on the XA_WM ICON NAME property 
of the specified window. XGet WMIconName supersedes XGet IconName. 


This function is primarily used by window managers to get the name to be written in a win- 
dow’s icon when they need to display that icon. 


For more information, see Volume One, Chapter 10, Interclient Communication. 


Structures 
typedef struct { 
unsigned char *value; /* same as Property routines */ 
Atom encoding; /* prop type */ 
int “toxrmat ; jx prop data. format: 8, .ulr6yimorn Seb / 
unsigned long nitems; /* number of data items in value */ 


} XTextProperty; 


Related Commands 
XGetWMName, XSetWMIconName, XSetWMName, XSetWMProperties. 


Xlib Reference Manual : : 255 


XGetWMName Xlib — Window Manager Hints— 


Name 
XGetWMName — read a window’s XA_WM_ NAME property. 


Synopsis 
Status XGetWMName (display, w, text_prop) 
Display *display; 
Window w; 
XTextProperty *text_prop;/* RETURN */ 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
Ww Specifies. the window. 


text_prop Returns the XText Property Structure. 


Availability 
Release 4 and later. 


Description 
XGet WMName performs an XGet TextProperty on the XA_WM NAME property of the speci- 
fied window. XGet WMName supersedes XFet chName. 


XGetWMName returns nonzero if it succeeds, and zero if the property has not been set for the 
argument window. 


For more information, see Volume One, Chapter 10, /nterclient Communication. 


Structures 
typedef struct { 
unsigned char *value; /* same as Property routines */ 
Atom encoding; /* prop type */ 
int format; Je EOP data format: 8. shearer och */ 
unsigned long nitems; /* number of data items in value */ 
} XTextProperty; 


Related Commands 
XGetWMIconName, XSetWMIconName, XSetWMName, XSetWMProperties. 
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Name 
XGetW MNormalHints — read a window’s XA_WM: NORMAL_HINTS property. 


Synopsis 
Status XGetWMNormalHints (display, w, hints, supplied) 
Display *display; 
Window w; 
XSizeHints *hints;/* RETURN */ 
long *supplied; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
w Specifies the window. 
hints Returns the size hints for the window in its normal state. 


supplied Returns the hints that were supplied by the user. 


Availability 
Release 4 and later. 


Description 

XGetWMNormalHints returns the size hints stored in the XA_WM NORMAL HINTS property on 
the specified window. If the property is of type XA_WM SIZE HINTS, of format 32, and is long 
enough to contain either an old (pre-ICCCM) or new size hints structure, XGet WMNormal- 
Hints sets the various fields of the XSizeHints structure, sets the supplied argument to 
the list of fields that were supplied by the user (whether or not they contained defined values) 
and returns a non-zero status. XGetWMNormalHints returns a zero status if the application 
specified no normal size hints for this window. 


XGetWMNormalHints supersedes XGetNormalHints. 


If XGetWMNormalHints returns successfully and a pre-ICCCM size hints property is read, 
the supplied argument will contain the following bits: 


(USPosition|USSize|PPosition|PSize|PMinSize| PMaxSize|PResizelInc|PAspect) 


If the property is large enough to contain the base size and window gravity fields as well, the 
supplied argument will also contain the following bits: 


(PBaseSize|PWinGravity) 


This function is normally used only by a window manager. 


For more information, see Volume One, Chapter 10, Interclient Communication. 


Structures 
typedef struct { 
long flags; /* marks which fields in this structure are defined */ 
ANG, Kp YS /* obsolete for new window mgrs, but clients */ 
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int width, height; /* should set so old wm’s don’t mess up */ 
int min width, min_height; 
int max_width, max_height; 
IniEewadeheiNcy, NeLghte enc, 
Struct sh 
int x; /* numerator */ 
int y; /* denominator */ 
} min_aspect, max_aspect; 
int base width, base height; /* added by ICCCM version 1 */ 
int win_gravity; /* added by ICCCM 
version 1 */ 
} XSizeHints; 


Errors 
BadWindow 


Related Commands 
XAllocSizeHints, XGetWMSizeHints, XSetWMNormalHints, xSet- 
WMP roperties, XSetWMSizeHints. 
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Name : 
XGetWMSizeHints — read a window’s XA_WM_S{ZE_HINTS property. 


Synopsis 
Status XGetWMSizeHints (display, w, hints, supplied, property) 
Display *display; 
Window w; 
XSizeHints *hints; /* RETURN */ 
long *supplied; ei /*RETURN */ 
Atom property; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
w Specifies the window. 
hints Returns the XSizeHints structure. 


supplied Returns the hints that were supplied by the user. 
property Specifies the property name. 


Availability 
Release 4 and later. 


Description 

XGetWMSizeHints returms the size hints stored in the specified property on the named win- 
dow. If the property is of type XA_WM_SIZE_HINTS, of format 32, and is long enough to con- 
tain either an old (pre-ICCCM) or new size hints structure, XGet WMSizeHints sets the vari- 
ous fields of the XSizeHints structure, sets the supplied argument to the list of fields that 
were supplied by the user (whether or not they contained defined values), and returns a non- 
zero status. If the hint was not set, it returns a zero status. To get a window’s normal size hints, 
you can use the XGet WMNormalHints function instead. 


XGetWMSizeHints supersedes XGetSizeHints. 


If XGetWMSizeHints returns successfully and a pre-ICCCM size hints property is read, the 
supplied argument will contain the following bits: 


(USPosition|USSize|PPosition|PSize|PMinSize| PMaxSize|PResizelInc|PAspect) 


If the property is large enough to contain the base size and window gravity fields as well, the 
supplied argument will also contain the following bits: 


(PBaseSize|PWinGravity) 


This function is used almost exclusively by window menagers. 


For more information, see Volume One, Chapter 10, Interclient Communication. 
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Structures 
typedef struct { 
long flags; /* marks which fields in this structure are defined */ 
int xX, y; /* obsolete for new window mgrs, but clients */ 
int width, height; /* should set so old wm’s don’t mess up */ 
int min_width, min height; 
int max width, max height; 
int width inc, height inc; 
Struct at 


int x; /* numerator */ 
int y; /* denominator */ 


} min_aspect, max_aspect; 


int 
pire 


base width, base height; 
win gravity; 


} XSizeHints; 


Errors 


BadAtom 
BadWindow 


Related Commands 


XAllocSizeHints, XGetWMNormalHints, 


Hints. 
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/* added by ICCCM version 1 */ 
/* added by ICCCM version 1 */ 


XSetWMNormalHints, XSetWMSize- 
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Name , 
XGetWindowAttributes — obtain the current attributes of window. 


Synopsis 
Status XGetWindowAttributes (display, w, window_attributes) 
Display *display; 
Window w; 
XWindowAttributes *window_attributes; /* RETURN */ 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 


w Specifies the window whose current attributes you want. 


window_attributes 
Returns a filled xWindowAttributes structure, containing the current attri- 
butes for the specified window. 


Description 
XGetWindowAttributes retums the XWindowAtt ributes structure containing the cur- 
rent window attributes. 


While w is defined as type Window, a Pixmap can also be used, in which case all the returned 
members will be zero except width, height, depth, and screen. 


XGetWindowAttributes returns a Status of zero on failure, or nonzero on success. 
However, it will only return zero if you have defined an error handler that does not exit, using 
XSetErrorHandler. The default error handler exits, and therefore XGetWindow- 
Attributes never gets a chance to return. (This is relevant only if you are writing a window 
manager or other application that deals with windows that might have been destroyed.) 


The following list briefly describes each member of the XWindowAttributes structure. For 
more information, see Volume One, Chapter 4, Window Attributes. 


al, The current position of the upper-left pixel of the window’s border, relative 
to the origin of its parent. 


width, height The current dimensions in pixels of this window. 


border width Thecurrent border width of the window. 


depth The number of bits per pixel in this window. 

visual The visual structure. 

root The root window ID of the screen containing the window. 

class The window class. One of these constants: InputOutput or Input- 
Only. 


bit gravity The new position for existing contents after resize. One of the constants 
ForgetGravity, StaticGravity, or CenterGravity, or one of 
the compass constants (NorthWestGravity, NorthGravity, etc.). 
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win gravity The new position for this window after its parent is resized. One of the 
constants CenterGravity, UnmapGravity, StaticGravity, or 
one of the compass constants. 


backing store When to maintain contents of the window. One of these constants: Not - 
Useful, WhenMapped, or Always. 


backing planes 
The bit planes to be preserved in a backing store. 


backing _pixel The pixel value used when restoring planes from a partial backing store. 


save_under A boolean value, indicating whether saving bits under this window would 
be useful. 
colormap The colormap ID being used in this window, or None. 


map installed A boolean value, indicating whether the colormap is currently installed. If 
True, the window is being displayed in its chosen colors. 


map state The window’s map state. One of these constants: IsUnmapped, Is- 
Unviewable, or IsViewable. IsUnviewable indicates that the 
specified window is mapped but some ancestor is unmapped. 


all _event_masks 
The set of events any client have selected. This member is the bitwise 
inclusive OR of all event masks selected on the window by all clients. 


your_event_mask 
The bitwise inclusive OR of all event mask symbols selected by the query- 
ing client. 

do_not_propagate_mask 
The bitwise inclusive OR of the event mask symbols that specify the set of 
events that should not propagate. This is global across all clients. 


override redirect 
A boolean value, indicating whether this window will override structure 


control facilities. This is usually only used for temporary pop-up windows 
such as menus. Either True or False. 


screen A pointer to the Screen structure for the screen containing this window. 


Errors 


BadWindow 


Structures 
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The XWindowAttributes structure contains: 


typedef struct { 


IMEGX pave /* location of window */ 

int width, height; /* width and height of window */ 
int border width; /* border width of window */ 

int depth; /* depth of window */ 
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Visual *visual; /* the associated visual structure */ 

Window root; '/* reot of screen containing window */ 
int class; /* InputOutput, InputOnly*/ 

int bit gravity; /* one of bit gravity values */ 

int win_gravity; /* one of the window gravity values */ 
int backing store; /* NotUseful, WhenMapped, Always */ 


unsigned long backing planes;/* planes to be preserved if possible */ 
unsigned long backing pixel; /* value to be used when restoring planes */ 


Bool save_under; /* boolean, should bits under be saved */ 
Colormap colormap; /* colormap to be associated with window */ 
Bool map_installed; /* boolean, is colormap currently installed*/ 
int map_state; /* IsUnmapped, IsUnviewable, IsViewable */ 
long all_event_masks; /* set of events all people have interest in*/ 
long your _event_mask; /* my event mask */ 

long do_not_ propagate mask; /* set of events that should not propagate */ 
Bool override redirect; /* boolean value for override-redirect */ 
Screen *screen; /* pointer to correct screen */ 


} XWindowAttributes; 


Related Commands 
XChangeWindowAttributes, XGetGeomet ry, XSetWindowBackground, XSet- 
WindowBackgroundPixmap, XSetWindowBorder, XSetWindowBorderPixmap. 
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Name 
XGetWindowProperty — obtain the atom type and property format for a window. 


Synopsis 
int XGetWindowProperty (display, w, property, long offset, 

long _length,. delete, req type, actual_type, actual for- 
mat, nitems, bytes_after, prop) 

Display *display; 

Window w; 

Atom property; 

long long offset, long.length; 

Bool delete; 

Atom req type; . 


Atom *actual_type; /* RETURN */ 
int *actual_format; Le RE LUBN .* / 
unsigned long *nitems; /* RETURN */ 
unsigned long *bytes_after; /* RETURN */ 
unsigned char **prop; /* RETURN */ 
Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
w Specifies the ID of the window whose atom type and property format you 


want to obtain. 
property Specifies the atom of the desired property. 
long_offset Specifies the offset in 32-bit quantities where data will be retrieved. 
long length Specifies the length in 32-bit multiples of the data to be retrieved. 


delete Specifies a boolean value of True or False. If you pass True and a prop- 
erty is returned, the property is deleted from the window after being read and 
aPropertyNotify event is generated on the window. 


req type Specifies an atom describing the desired format of the data. If Any- 
PropertyType is specified, returns the property from the specified window 
regardless of its type. If a type is specified, the function returns the property 
only if its type equals the specified type. 


actual _type Returns the actual type of the property. 


actual format 
Returns the actual data type of the returned data. 


nitems Returns the actual number of 8-, 16-, or 32-bit items returned in prop. 


bytes_after Returns the number of bytes remaining to be read in the property if a partial 
read was performed. 
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prop Returns a pointer to the data actually returned, in the specified format. 
XGetWindowP roperty always allocates one extra byte after the data and 
sets it to NULL. This byte is not counted in nitems. 


Description 
XGetWindowProperty gets the value of a property if it is the desired type. XGet Window- 
Property sets the return arguments acccording to the following rules: 


° If the specified property does not exist for the specified window, then: actual_type is 
None; actual_format = 0;and bytes_after = 0. delete is ignored in this 
case, and nitems is empty. 


° If the specified property exists, but its type does not match req type, then: 
actual_type is the actual property type; actual_format is the actual property 
format (never zero); and bytes after is the property length in bytes (even if 
actual format is 16 or 32). delete is ignored in this case, and nitems is empty. 


° If the specified property exists, and either req type is AnyPropertyType or the 
specified type matches the actual property type, then: actual_type is the actual prop- 
erty type; and actual format is the actual property format (never zero). 
bytes_afterand nitems are defined by combining the following values: 


N = actual length of stored property in bytes (even if actual _format is 16 or 32) 

I = 4 * long offset (convert offset from longs into bytes) 

L = MINIMUM((N - I), 4 * long length) (BadValue if L < 0) 
bytes after = N - (I + L) (numberof trailing unread bytes in stored property) 


The returned data (in prop) starts at byte index I in the property (indexing from 0). The 
actual length of the returned data in bytes is L. L is converted into the number of 8-, 16-, 
or 32-bit items returned by dividing by 1, 2, or 4 respectively and this value is returned in 
nitems. The number of trailing unread bytes is returned in bytes_after. 


If delete == True and bytes after == 0 the function deletes the property 
from the window and generates a PropertyNotify event on the window. 


When XGetWindowProperty executes successfully, it returns Success. The Success 
return value and the undocumented value returned on failure are the opposite of all other rou- 
tines that return int or Status. The value of Success is undocumented, but is zero (0) in 
the current sample implementation from MIT. The failure value, also undocumented, is cur- 
rently one (1). Therefore, comparing either value to True or False, or using the syntax “if 
(!XGetWindowProperty(...))” isnot allowed. 


To free the resulting data, use XF ree. 


For more information, see Volume One, Chapter 10, Jnterclient Communication. 
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Errors 
BadAtom 


BadValue Value of long_offset caused L to be negative above. 
BadWindow 
Related Commands 


XChangeProperty, XGetAtomName, XGetFontProperty, XListProperties, 
XRotateWindowProperties, XSetStandardProperties. 
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Name 
XGetWMHints — read the window manager hints-property. 


Synopsis 
XWMHints *XGetWMHints (display, w) 
Display *display; 
Window w; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
w Specifies the ID of the window to be queried. 

Description 


This function is primarily for window managers. XGetWMHints returns NULL if no 
XA_WM HINTS property was set on window w, and returns a pointer to an XWMHints structure 
if it succeeds. Programs must free the space used for that structure by calling xF ree. 


For more information on using hints, see Volume One, Chapter 10, Jnterclient Communication. 


Structures 
typedef struct { 

long flags; /* marks which fields in this structure are defined */ 
Bool input; /* does application need window manager for input */ 
int ipitial state: {* see below *7 
Pixmap icon _pixmap; /* pixmap to be used as icon */ 
Window icon window; /* window to be used as icon */ 
int icon x, icon y; /* Anitial position of icon */ 
Pixmap icon_mask; /* icon mask bitmap */ 
XID window group; /* ID of related window group */ 


/* this structure may be extended in the future */ 
} XWMHints; 


/* initial state flags */ 
#define DontCareState 
#define NormalState 
#define ZoomState 

#define IconicState 
#define InactiveState 


Bm WHR OO 


Errors 
BadWindow 


Related Commands 
XAllocWMHints, XFetchName, XGetClassHint, XGetIconName, XGetIcon- 
Sizes, XGetNormalHints, XGetSizeHints, XGetTransientForHint, XGet- 
ZoomHints, XSetClassHint, XSetCommand, XSet IconName, XSetIconSizes, 
XSetNormalHints, XSetSizeHints, XSetTransientForHint, XSetWMHints, 
XSet ZoomHints, XStoreName, XSetWMProperties. 
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Name 
XGetZoomHints — read the size hints property of a zoomed window. 


Synopsis 
Status XGetZoomHints (display, w, zhints) 
Display *display; 
Window w; 


XSizeHints *zhints; /* RETURN */ 
Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
w Specifies the ID of the window to be queried. 
zhints Returns a pointer to the zoom hints. 
Description . 


XGetZoomHints is obsolete beginning in Release 4, because zoom hints are no longer 
defined in the ICCCM. 


XGetZoomHints is primarily for window managers. XGetZoomHints returns the size 
hints for a window in its zoomed state (not normal or iconified) read from the 
XA_WM_ZOOM HINTS property. It returns a nonzero Status if it succeeds, and zero if the 
application did not specify zoom size hints for this window. 


For more information on using hints, see Volume One, Chapter 10, Interclient Communication. 


Structures 
typedef struct { 

long flags; /* which fields in structure are defined */ 
Tata ene Sue Vie 
int width, height; 
int min_width, min_height; 
int max_width, max height; 
inter wadth inc, height. ine; 


Sneagieie. x 
sieiaiitemesces /* numerator */ 
MeN /* denominator */ 
} min aspect, max aspect; 
} XSizeHints; 


/* flags argument in size hints */ 
#define USPosition (1L << 0) /* user specified x, ky 


#define USSize (1L << 1) /* user specified width, height */ 

#define PPosition (1L << 2) /* program specified position */ 

#define PSize (lL << 3) /* program specified size */ 

#define PMinSize (1L << 4) /* program specified minimum size */ 

#define PMaxSize (1L << 5) /* program specified maximum size */ 
( 


#define PResizeInc (1L << 6) /* program specified resize increments */ 
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#define PAspect (1L << 7) /* program specified min/max aspect ratios */ 
#define PAllHints (PPosition|PSize|PMinSize|PMaxSize|PResizelInc|PAspect) 


Errors 
BadWindow 


Related Commands 
XFetchName, XGetClassHint, XGetIconName, XGetIconSizes, XGetNormal- 
Hints, XGetSizeHints, XGetTransientForHint, XGetWMHints, XSetClass- 
Hint, XSetCommand, XSetIconName, XSetIconSizes, XSetNormalHints, XSet- 
SizeHints, XSetTransientForHint, XSetWMHints, XSetZoomHints, XStore- 
Name. 
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Name 
XGrabButton — grab a pointer button. 


Synopsis 
XGrabButton (display, button, modifiers, grab_window, 
owner events, event_mask, pointer_mode, keyboard_mode, 
confine to, cursor) 
Display *display; 
unsigned int button; 
unsigned int modifiers; 
Window grab_window; 
Bool owner_events; 
unsigned int event_mask; 
int pointer_mode, keyboard_mode; 
Window confine _ to; 
Cursor cursor; 


Arguments 


270 


display 
button 


modifiers 


Specifies a connection to an X server; returned from XOpenDisplay. 


Specifies the mouse button. May be Button1, Button2, Button3, But- 
ton4, ButtonS5, or AnyButton. The constant AnyButton is equivalent 
to issuing the grab request for all possible buttons. The button symbols can- 
not be ORed. 


Specifies a set of keymasks. This is a bitwise OR of one or more of the fol- 
lowing symbols: ShiftMask, LockMask, ControlMask, Mod1Mask, 
Mod2Mask, Mod3Mask, Mod4Mask, Mod5Mask, or AnyModifier. 
AnyModifier is equivalent to issuing the grab key request for all possible 
modifier combinations (including no modifiers). 


grab_window Specifies the ID of the window you want to the grab to occur in. 


owner events 


event_mask 


Specifies a boolean value of either True or False. See Description below. 


Specifies the event mask to take effect during the grab. This mask is the bit- 
wise OR of one or more of the event masks listed on the reference page for 
XSelectInput. 


pointer _ mode 


Controls processing of pointer events during the grab. Pass one of these con- 
stants: GrabModeSync or GrabModeAsync. 


keyboard_mode 


confine_to 


Controls processing of keyboard events during the grab. Pass one of these 
constants: GrabModeSync or GrabModeAsync. 


Specifies the ID of the window to confine the pointer. One possible value is 
the constant None, in which case the pointer is not confined to any window. 
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cursor Specifies the cursor to be displayed during the grab. One possible value you 
can pass is the constant None, in-which case the existing cursor is used. 


Description 
XGrabButton establishes a passive grab, such that an active grab may take place when the 
specified key/button combination is pressed in the specified window. After this call, if 


1) the specified button is pressed when the specified modifier keys are down (and no other 
buttons or modifier keys are down), 


2) grab_window contains the pointer, — 
3) the confine_to window (if any) is viewable, and 
4) these constraints are not satisfied for any ancestor, 


then the pointer is actively grabbed as described in XGrabPointer, the last pointer grab time 
is set to the time at which the button was pressed, and the ButtonPress event is reported. 


The interpretation of the remaining arguments is as for XGrabPointer. The active grab is 
terminated automatically when all buttons are released (independent of the state of modifier 
keys). 


A modifier of AnyModifier is equivalent to issuing the grab request for all possible modifier 
combinations (including no modifiers). A button of AnyButton is equivalent to issuing the 
request for all possible buttons (but at least one). 


XGrabButton overrides all previous passive grabs by the same client on the same key/button 
combination on the same window, but has no effect on an active grab. The request fails if some 
other client has already issued an XGrabButton with the same button/key combination on the 
same window. When using AnyModifier or AnyButton, the request fails completely (no 
grabs are established) if there is a conflicting grab for any combination. 


The owner _events argument specifies whether the grab window should receive all events 
(False) or whether the grabbing application should receive all events normally (True). 


The pointer_mode and keyboard_mode control the processing of events during the grab. 
If either is GcabModeSync, events for that device are not sent from the server to Xlib until 
XAllowEvents is called to release the events. If either is GcabModeAsync, events for that 
device are sent normally. 


An automatic grab takes place between a ButtonPress event and the corresponding 
ButtonRelease event, so this call is not necessary in some of the most common situations. 
But this call is necessary for certain styles of menus. 


For more information on grabbing, see Volume One, Chapter 9, The Keyboard and Pointer. 
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Errors 
BadAccess 


BadCursor 
BadValue 


BadWindow 


(continued) Xlib — Grabbing 


When using AnyModifier or AnyButton and there is a conflicting grab 
by another client. No grabs are established. 


Another client has already issued an XGrabButton request with the same 
key/button combination on the same window. 


Related Commands 


XChangeActivePointerGrab, XGrabKey, XGrabKeyboard, XGrabPointer, 


XGrabServer, XUngrabButton, XUngrabKey, XUngrabKeyboard, XUngrab- 
Pointer, XUngrabServer. 
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Name 
XGrabKey — grab a key. 


Synopsis 
XGrabKey (display, keycode, modifiers, grab_window, 
owner events, pointer mode, keyboard_mode) 

Display *display; 
int keycode; 
unsigned int modifiers; 
Window grab_window; 
Bool owner events; 
int pointer mode, keyboard_mode; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
keycode Specifies the keycode to be grabbed. It may be a modifier key. Specifying 


AnyKey is equivalent to issuing the request for all key codes. 


modifiers Specifies a set of keymasks. This is a bitwise OR of one or more of the fol- 
lowing symbols: ShiftMask, LockMask, ControlMask, Mod1Mask, 
Mod2Mask, Mod3Mask, Mod4Mask, Mod5Mask, or AnyModifier. 
AnyModifier is equivalent to issuing the grab key request for all possible 
modifier combinations (including no modifiers). All specified modifiers do 
not need to have currently assigned keycodes. 


grab_window Specifies the window in which the specified key combination will initiate an 
active grab. 


owner events 
Specifies whether the grab window should receive all events (True) or 
whether the grabbing application should receive all events normally 
(False). 


pointer _mode 
Controls processing of pointer events during the grab. Pass one of these con- 
stants: GcabModeSync or GrabModeAsync. 


keyboard_mode 
Controls processing of keyboard events during the grab. Pass one of these 
constants: GrabModeSync or GrabModeAsync. 
Description 
XGrabKey establishes a passive grab on the specified keys, such that when the specified 
key/modifier combination is pressed, the keyboard may be grabbed, and all keyboard events 


sent to this application. More formally, once an XGrabKey call has been issued on a particular 
key/button combination: 
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IF the keyboard is not already actively grabbed, 


AND the specified key, which itself can be a modifier key, is logically pressed when the 
specified modifier keys are logically down, 


AND no other keys or modifier keys are logically down, 


AND EITHER the grab window is an ancestor of (or is) the focus window OR the grab 
window is a descendent of the focus window and contains the pointer, 


AND a passive grab on the same key combination does not exist on any ancestor of the 
grab window, 


THEN the keyboard is actively grabbed, as for XGrabKeyboard, the last keyboard grab 
time is set to the time at which the key was pressed (as transmitted in the KeyPress 
event), and the KeyPress event is reported. 


The active grab is terminated automatically when the specified key is released (independent of 
the state of the modifier keys). 


The pointer_mode and keyboard_mode control the processing of events during the grab. 
If either is GrabModeSync, events for that device are not sent from the server to Xlib until 
XAllowEvents is called to send the events. If either is GrabModeAsync, events for that 
device are sent normally. 


For more information on grabbing, see Volume One, Chapter 9, The Keyboard and Pointer. 


Errors 


BadAccess When using AnyModifier or AnyKey and another client has grabbed any 


overlapping combinations. In this case, no grabs are established. 


Another client has issued XGrabKey for the same key combination in 
grab_window. 


BadValue keycode is not in the range between min_keycode and max_keycode 


as returned by XDisplayKeycodes. 


BadWindow 


Related Commands 
XChangeActivePointerGrab, XGrabButton, XGrabKeyboard, XGrabPointer, 
XGrabServer, XUngrabButton, XUngrabKey, XUngrabKeyboard, XUngrab- 
Pointer, XUngrabServer. 


274 


Xlib Reference Manual 


—Xlib — Grabbing ) XGrabKeyboard 


Name / 
XGrabKeyboard — grab the keyboard. i 


Synopsis 
int XGrabKeyboard (display, grab_window, owner events, 
pointer mode, keyboard_mode, time) 
Display *display; 
Window grab_window; 
Bool owner events; 
int pointer mode, keyboard_mode; 
Time time; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
grab_window Specifies the ID of the window that requires continuous keyboard input. 


owner events 
Specifies a boolean value of either True or False. See Description below. 


pointer _mode 
Controls processing of pointer events during the grab. Pass either Grab- 
ModeSync or GrabModeAsync. 


keyboard_mode 
Controls processing of keyboard events during the grab. Pass either Grab- 
ModeSync or GrabModeAsync. 


time Specifies the time when the grab should take place. Pass either a timestamp, 
expressed in milliseconds, or the constant Current Time. 


Description 
XGrabKeyboard actively grabs control of the main keyboard. Further key events are 
reported only to the grabbing client. This request generates FocusIn and FocusOut events. 


XGrabKeyboard processing is controlled by the value in the owner_events argument: 
° If owner_events is False, all generated key events are reported to grab_window. 


° If owner_events is True, then if a generated key event would normally be reported 
to this client, it is reported normally. Otherwise the event is reported to grab_ window. 


Both KeyPress and KeyRelease events are always reported, independent of any 
event selection made by the client. 


XGrabKeyboard processing of pointer events and keyboard events are controlled by 
pointer _modeand keyboard_mode: 


° If the pointer_mode or keyboard_mode’is GrabModeAsync, event processing 
for the respective device continues normally. 


°. For keyboard_mode GrabModeAsync only: if the keyboard was currently frozen 
by this client, then processing of keyboard events is resumed. 
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. If the pointer_mode or keyboard_mode is GrabModeSync, events for the 
respective device are queued by the server until a releasing XAllowEvents request 
occurs or until the keyboard grab is released as described above. 


If the grab is successful, XGrabKeyboard returns the constant GrabSuccess. XGrab- 
Keyboard fails under the following conditions and returns the following: 


° If the keyboard is actively grabbed by some other client, it returns AlreadyGrabbed. 


° If grab_windowis not viewable, it returns GcabNot Viewable. 

° If time is earlier than the last keyboard grab time or later than the current server time, it 
retums GrabInvalidTime. 

° If the pointer is frozen by an active grab of another client, the request fails with a status 
GrabFrozen. 


If the grab succeeds, the last keyboard grab time is set to the specified time, with Current- 
Time replaced by the current X server time. 


For more information on grabbing, see Volume One, Chapter 9, The Keyboard and Pointer. 


Errors 
BadValue 
BadWindow 


Related Commands 
XChangeActivePointerGrab, XGrabButton, XGrabKey, XGrabPointer, XGrab- 


Server, XUngrabButton, XUngrabKey, XUngrabKeyboard, XUngrabPointer, 
XUngrabServer. 
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Name 


XGrabPointer — grab the pointer. | : 


Synopsis 


int XGrabPointer (display, grab_window, owner events, 

event_mask, pointer_mode, keyboard_mode, confine_to, 
cursor, time) 

Display *display; 

Window grab_window; 

Bool owner events; 

unsigned int event_mask; 

int pointer _mode, keyboard_mode; 

Window confine_to; 

Cursor cursor; 

Time time; 


Arguments 
display 


Specifies a connection to an X server; returned from XOpenDisplay. 


grab_window Specifies the ID of the window that should grab the pointer input independent 


of pointer location. 


owner events 


event_mask 


Specifies if the pointer events are to be reported normally within this applica- 
tion (pass True) or only to the grab window (pass False). 


Specifies the event mask symbols that can be ORed together. Only events 
selected by this mask, plus ButtonPress and ButtonRelease, will be 
delivered during the grab. See XSelect Input for a complete list of event 
masks. 


pointer_mode 


Controls further processing of pointer events. Pass either GrabModeSync 
or GrabModeAsync. 


keyboard_mode 


confine_to 


cursor 


time 
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Controls further processing of keyboard events. Pass either GrabModeSync 
or GrabModeAsync. 


Specifies the ID of the window to confine the pointer. One option is None, in 
which case the pointer is not confined to any window. 


Specifies the ID of the cursor that is displayed with the pointer during the 
grab. One option is None, which causes the cursor to keep its current pattern. 


Specifies the time when the grab request took place. Pass either a timestamp, 
expressed in milliseconds (from an event), or the constant Current Time. 
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Description 
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XGrabPointer actively grabs control of the pointer. Further pointer events are only reported 
to the grabbing client until XUngrabPointer is called. 


event_mask is always augmented to include ButtonPressMask and ButtonRelease- 
Mask. If owner_events is False, all generated pointer events are reported to 
grab_window, and are only reported if selected by event_mask. If owner_events is 
True, then if a generated pointer event would normally be reported to this client, it is reported 
normally; otherwise the event is reported with respect to the grab_window, and is only 
reported if selected by event_mask. For either value of owner_events, unreported events 
are discarded. 


pointer _mode controls processing of pointer events during the grab, and keyboard_mode 
controls further processing of main keyboard events. If the mode is GcabModeAsync, event 
processing continues normally. If the mode is GrabModeSync, events for the device are 
queued by the server but not sent to clients -until the grabbing client issues a releasing 
XAllowEvents request or an XUngrabPointer request. 


If a cursor is specified, then it is displayed regardless of which window the pointer is in. If no 
cursor is specified, then when the pointer is in grab_window or one of its subwindows, the 
normal cursor for that window is displayed. When the pointer is outside grab window, the 
cursor for grab_windowis displayed. 


If a confine_to window is specified, then the pointer will be restricted to that window. The 
confine_to window need have no relationship to the grab_window. If the pointer is not 
initially in the confine_to window, then it is warped automatically to the closest edge (and 
enter/leave events generated normally) just before the grab activates. If the confine_to 
window is subsequently reconfigured, the pointer will be warped automatically as necessary to 
keep it contained in the window. 


The time argument lets you avoid certain circumstances that come up if applications take a 
long while to respond or if there are long network delays. Consider a situation where you have 
two applications, both of which normally grab the pointer when clicked on. If both applica- 
tions specify the timestamp from the ButtonPress event, the second application will suc- 
cessfully grab the pointer, while the first will get a return value of Al readyGrabbed, indicat- 
ing that the other application grabbed the pointer before its request was processed. This is the 
desired response because the latest user action is most important in this case. 


XGrabPointer generates EnterNotify and LeaveNotify events. 


If the grab is successful, it returns the constant GrabSuccess. The XGrabPointer func- 
tion fails under the following conditions, with the following return values: 


° If grab_window or confine_to window is not viewable, or if the conf ine to 
window is completely off the screen, GrabNot Viewab]1e is returned. 


° If the pointer is actively grabbed by some other client, the constant AlreadyGrabbed 
is returned. 


° If the pointer is frozen by an active grab of another client, GrabF rozen is returned. 
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° If the specified time is earlier than the last-pointer-grab time or later than the current X 
server time, GrabInvalidTime is returned. (If the call succeeds, the last pointer grab 
time is set to the specified time, with the constant Current Time replaced by the cur- 
rent X server time.) 


For more information on grabbing, see Volume One, Chapter 9, The Keyboard and Pointer. 


Errors 
BadCursor 
BadValue 
BadWindow 


Related Commands 
XChangeActivePointerGrab, XGrabButton, XGrabKey, XGrabKeyboard, 
XGrabServer, XUngrabButton, XUngrabKey, XUngrabKeyboard, XUngrab- 
Pointer, XUngrabServer. 
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Name 
XGrabServer — grab the server. 


Synopsis 
XGrabServer (display) 
Display *display; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 


Description 
Grabbing the server means that only requests by the calling client will be acted on. All others 
will be queued in the server until the next XUngrabServer call. The X server should not be 
grabbed any more than is absolutely necessary. 


Related Commands 
XChangeActivePointerGrab, XGrabButton, XGrabKey, XGrabKeyboard, 
XGrabPointer, XUngrabButton, XUngrabKey, XUngrabKeyboard, XUngrab- 
Pointer, XUngrabServer. 
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Name ; 
XIconifyWindow — request that a top-level window be iconified. 


Synopsis 
Status XIconifyWindow (display, w, screen_number) 
Display *display; 
Window w; 
int screen_number; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
w Specifies the window. 


screen _number 
Specifies the appropriate screen number on the server. 


Availability 
Release 4 and later. 


Description 

XIconifyWindow sends a WM_CHANGE STATE ClientMessage event with a format of 32 
and a first data element of IconicState (as described in Section 4.1.4 of the Jnter-Client 
Communication Conventions Manual in Volume Zero, X Protocol Reference Manual), to the 
root window of the specified screen. Window managers may elect to receive this message and, 
if the window is in its normal state, may treat it as a request to change the window’s state from 
normal to iconic. If the WM_CHANGE STATE property cannot be interned, XIconifyWindow 
does not send a message and returns a zero status. It returns a nonzero status if the client mes- 
sage is sent successfully; otherwise, it returns a zero status. 


For more information, see Volume One, Chapter 10, Interclient Communication. 


Errors 
BadWindow 


Related Commands 
XReconfigureWindow, XWithdrawWindow. 
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Name 
XIfEvent — wait for event matched in predicate procedure. 


Synopsis 
XIfEvent (display, event, predicate, args) 
Display *display; 
XEvent *event; /* RETURN */ 
Bool (*predicate) (); 
char *args; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
event Returns the matched event. 


predicate Specifies the procedure to be called to determine if the next event satisfies 
your criteria. 


args Specifies the user-specified arguments to be passed to the predicate proce- 
dure. 


Description 
XIfEvent checks the event queue for events, uses the user-supplied routine to check if one 
meets certain criteria, and removes the matching event from the input queue. XIfEvent 
returns only when the specified predicate procedure returns True for an event. The specified 
predicate is called once for each event on the queue until a match is made, and each time an 
event is added to the queue, with the arguments display, event, and arg. 


If no matching events exist on the queue, XIfEvent flushes the request buffer and waits for an 
appropriate event to arrive. Use XCheckIfEvent if you don’t want to wait for an event. 


For more information, see Volume One, Chapter 8, Events. 


Related Commands 
QLength, XAllowEvents, XCheckIfEvent, XCheckMaskEvent, XCheckTyped- 
Event, XCheckTypedWindowEvent, XCheckWindowEvent, XEventsQueued, 
XGet InputFocus, XGetMotionEvents, XMaskEvent, XNextEvent, XPeekEvent, 
XPeekIfEvent, XPending, XPutBackEvent, XSelectInput, XSendEvent, XSet- 
InputFocus, XSynchronize, XWindowEvent. 
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Name : 
XInsertModifiermapEntry — add a new entry to an XModifierKeymap structure. 


Synopsis 
XModifierKeymap *XInsertModifiermapEntry (modmap, 
keysym_entry, modifier) 
XModifierKeymap *modmap; 
KeyCode keysym_entry; 
int modifier; 


Arguments 
modmap Specifies a pointer to an XModifierKeymap Structure. 


keysym_entry 
Specifies the keycode of the key to be added to modmap. 


modifier Specifies the modifier you want mapped to the keycode specified in 

keysym_entry. This should be one of the constants: ShiftMapIndex, 
LockMapIndex, ControlMapIndex, ModlMapIndex, Mod2Map- 
Index, Mod3MapIndex, Mod4MapIndex, or Mod5MapIndex. 


Description 
XInsertModifiermapEntry returns an XModifierKeymap structure suitable for cal- 
ling XSetModifierMapping, in which the specified keycode is deleted from the set of key- 
codes that is mapped to the specified modifier (like Shift or Control). XInsert- 
ModifiermapEnt ry does not change the mapping itself. 


This function is normally used by calling XGetModifierMapping to get a pointer to the 
current XModifierKeymap structure for use as the modmap argument to XInsert- 
ModifiermapEntry. 


Note that the structure pointed to by modmap is freed by XInsertModifiermapEntry. It 
should not be freed or otherwise used by applications. 


For a description of the modifier map, see XSetModifierMapping. 


Structures 
typedef struct { 
int max_keypermod; /* server's max number of keys per modifier */ 


KeyCode *modifiermap; /* an 8 by max _keypermod array of 
x keycodes to be used as modifiers */ 
} XModifierKeymap; 


#define ShiftMapIndex 
#define LockMapIndex 
#define ControlMapIndex 
#define Mod1MapIndex 

- #define Mod2MapIndex 
#define Mod3MapIndex 


O&WN Fe O 
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#define Mod4MapIndex 6 
#define Mod5MapIndex 7 


Related Commands 
XDeleteModifiermapEntry, XFreeModifiermap, XGetKeyboardMapping, 
XGetModifierMapping, XKeycodeToKeysym, XKeysymToKeycode, XKeysymTo- 
String, XLookupKeysym, XLookupSt ring, XNewModifierMap, XQueryKeymap, 
XRebindKeySym, XRefreshKeyboardMapping, XSetModifierMapping, 
XStringToKeysym. 
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Name ; 
XInstallColormap — install a colormap. 
Synopsis 
XInstallColormap (display, cmap) 
Display *display; 
Colormap cmap; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
cmap Specifies the colormap to install. 

Description 


XInstallColormap installs a virtual colormap into a hardware company. If there is only 
one hardware colormap, XInstallColormap loads a virtual colormap into the hardware 
colormap. All windows associated with this colormap immediately display with their chosen 
colors. Other windows associated with the old colormap will display with false colors. 


If additional hardware colormaps are possible, XInstal1Colormap loads the new hardware 
map and keeps the existing ones. Other windows will then remain in their true colors unless the 
limit for colormaps has been reached. If the maximum number of allowed hardware colormaps 
is already installed, an old colormap is swapped out. The MinCmapsOf Screen (screen) 
and MaxCmapsOfScreen (screen) macros can be used to determine how many hardware 
colormaps are supported. 


If cmap is not already an installed map, a ColormapNotify event is generated on every 
window having cmap as an attribute. If a colormap is uninstalled as a result of the install, a 
ColormapNotify event is generated on every window having that colormap as an attribute. 


Colormaps are usually installed and uninstalled by the window manager, not by clients. 


At any time, there is a subset of the installed colormaps, viewed as an ordered list, called the 
“required list.” The length of the required list is at most the min_maps specified for each 
screen in the Display structure. When a colormap is installed with XInstall1Colormap it 
is added to the head of the required list and the last colormap in the list is removed if necessary 
to keep the length of the list at mim_maps. When a colormap is uninstalled with 
XUninstallColormap and it is in the required list, it is removed from the list. No other 
actions by the server or the client change the required list. It is important to realize that on all 
but high-performance workstations, min_maps is likely to be 1. 


If the hardware colormap is immutable, and therefore installing any colormap is impossible, 
XInstallColormap will work but not do anything. 


For more information, see Volume One, Chapter 7, Color. 


Errors 
BadColormap 
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Related Commands 
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DefaultColormap, DisplayCells, XCopyColormapAndF ree, XCreate- 
Colormap, XFreeColormap, XGetStandardColormap, XListInstalled- 
Colormaps, XSetStandardColormap, XSetWindowColormap, XUninstall- 
Colormap. 
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Name 
XInternAtom — return an atom for a given property name string. 


Synopsis 
Atom XInternAtom(display, property _name, only _ if exists) 
Display *display; 
char *property_name; 
Bool only_if_ exists; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 


property name 
Specifies the string name of the property for which you want the atom. Upper 
or lower case is important. The string should be in ISO LATIN-1 encoding, 
which means that the first 128 character codes are ASCII, and the second 128 
character codes are for special characters needed in western languages other 
than English. 


only if exists 
Specifies a boolean value: if no such property _name exists XIntern- 
Atom will return None if this argument is set to True or will create the atom 
if it is set to False. 


Description 
XInternAtom returns the atom identifier corresponding to string property _name. 


If the atom does not exist, then XInternAtom either returns None (if only_if_existsis 
True) or creates the atom and returns its ID (if only if _existsis False). 


The string name should be a null-terminated. Case matters: the strings “thing,” “Thing,” and 
“thinG” all designate different atoms. 


The atom will remain defined even after the client that defined it has exited. It will become 
undefined only when the last connection to the X server closes. Therefore, the number of atoms 
interned should be kept to a minimum. 


This function is the opposite of XGet At omName, which returns the atom name when given an 
atom ID. 


Predefined atoms require no call to XInternAtom. Predefined atoms are defined in 
<X11/Xatom.h> and begin with the prefix “XA_”. Predefined atoms are the only ones that do 
not require a call to XInternAtom. 


Errors 
BadAlloc 
BadValue 
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Related Commands 
xXChangeProperty, XDeleteProperty, XGetAtomName, XGetFontProperty, 
XGetWindowProperty, XListProperties, XRotateWindowProperties, XSet- 
StandardProperties. 
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Name 
XIntersectRegion — compute the intersection of two regions. 
Synopsis 
XIntersectRegion(sra, srb, dr) 
Region sra, srb; 


Region dr; /* RETURN */ 
Arguments 
sra Specify the two regions with which to perform the computation. 
Srb 
ar Returns the result of the computation. 
Description 


XIntersectRegion generates a region that is the intersection of two regions. 


Structures 
Region is a pointer to an opaque structure type. 


Related Commands 
XClipBox, XCreateRegion, XDest royRegion, XEmptyRegion, XEqualRegion, 
XOffsetRegion, XPointInRegion, XPolygonRegion, XRect InRegion, XSet- 


Region, XShrinkRegion, XSubtractRegion, XUnionRectWithRegion, XUnion- 
Region, XXorRegion. 
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Name 
XKeycodeToKeysym — convert a keycode to a keysym. 


Synopsis 
KeySym XKeycodeToKeysym(display, keycode, index) 
Display *display; 
KeyCode keycode; 
int index; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
keycode Specifies the keycode. 
index Specifies which keysym in the list for the keycode to return. 
Description 


XKeycodeToKeysym returns one of the keysyms defined for the specified keycode. 
XxKeycodeToKeysym uses internal Xlib tables. index specifies which keysym in the array 
of keysyms corresponding to a keycode should be returned. If no symbol is defined, 
XKeycodeToKeysymretums NoSymbol. 


Related Commands 
IsCursorKey, IsFunctionKkey, IsKeypadKey, IsMiscFunctionKkey, Is- 
ModifierKkey, IsPFKey, XChangeKeyboardMapping, XDeleteModifiermap- 
Entry, XDisplayKeycodes, XFreeModifiermap, XGetKeyboardMapping, XGet- 
ModifierMapping, XInsertModifiermapEntry, XKeysymToKeycode, XKeysym- 
ToString, XLookupKeysym, XLookupSt ring, XNewModifierMap, XQuery- 
Keymap, XRebindKeySym, XRefreshKeyboardMapping, XSetModifierMapping, 
XStringToKeysym. 
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Name 
XKeysymToKeycode — convert a keysym to the appropriate keycode. 


Synopsis 
KeyCode XKeysymToKeycode (display, keysym) 
Display *display; 
Keysym keysym; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
_keysym Specifies the keysym that is to be searched for. 
Description 


XKeysymToKeycode returns the keycode corresponding to the specified keysym in the cur- 
rent mapping. If the specified keysym is not defined for any keycode, XKeysymToKeycode 
returns zero. 


Related Commands 
IsCursorkey, IsFunctionkey, IsKeypadKey, IsMiscFunctionKey, Is- 
ModifierKey, IsPFKey, XChangeKeyboardMapping, XDeleteModifiermap- 
Entry, XDisplayKeycodes, XFreeModifiermap, XGetKeyboardMapping, XGet- 
ModifierMapping, XInsertModifiermapEntry, XKeycodeToKeysym, XKeysym- 
ToString, XLookupKeysym, XLookupSt ring, XNewModifierMap, XQuery- 
Keymap, XRebindKeySym, XRefreshKeyboardMapping, XSetModifierMapping, 
XStringToKeysym. 
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Name 


XKeysymToString — convert a keysym symbol to a string. 


Synopsis 


char *XKeysymToString (keysym) 
KeySym keysym; 


Arguments 


keysym Specifies the keysym that is to be converted. 


Description 


XKeysymToString converts a keysym symbol (a number) into a character string. The 
returned string is in a static area and must not be modified. If the specified keysym is not 
defined, XKeysymToString returns NULL. For example, XKeysymToString converts 
Te Shift to “Shift”. 


Note that XKeysymSt ring does not return the string that is mapped to the keysym, but only a 
string version of the keysym itself. In other words, even if the Fl key is mapped to the string “- 
STOP” using XRebindKeysym, XKeysymToSt ring still returns “Fl”. XLookupSt ring, 
however, would return “STOP”. 


In Release 4, XKeysymToSt ring can process keysyms that are not defined by the Xlib stan- 
dard. Note that the set of keysyms that are available in this manner and the mechanisms by 
which Xlib obtains them is implementation dependent. (In the MIT sample implementation, 
the resource file /usr/lib/X11/XKeysymDB is used starting in Release 4. The keysym name is 
used as the resource name, and the resource value is the keysym value in uppercase hexade- 
cimal.) 


Related Commands 
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IsCursorKey, IsFunctionKkey, IsKeypadKey, IsMiscFunctionkKey, Is- 
ModifierKkey, IsPFKey, XChangeKeyboardMapping, XDeleteModifiermap- 
Entry, X¥FreeModifiermap, XGetKeyboardMapping, XGetModifierMapping, 
XInsertModifiermapEntry, XKeycodeToKeysym, XKeysymToKeycode, 
XLookupKeysym, XLookupString, XNewModifierMap, XQueryKeymap, XRebind- 
Keysym, XRefreshKeyboardMapping, XSetModifierMapping, XStringTo- 
Keysym. 
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Name : 
XKillClient — destroy a client or its remaining resources. 
Synopsis 
XKillClient (display, resource) 
Display *display; 
ALD) RESOURCE): 


_ Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
resource Specifies any resource created by the client you want to destroy, or the con- 
stant AllTemporary. 
Description 


If a valid resource is specified, XKil1Client forces a close-down of the client that created 
the resource. If the client has already terminated in either RetainPermanent or Retain- 
Temporary mode, all of the client’s resources are destroyed. If All Temporary is specified 
in the resource argument, then the resources of all clients that have terminated in Retain- 
Temporary are destroyed. 


For more information, see Volume One, Chapter 13, Other Programming Techniques. 


Errors 
BadValue 


Related Commands 
XSetCloseDownMode. 
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Name 
XListDepths — determine the depths available on a given screen. 


Synopsis 
int *XListDepths (display, screen_number, count) 
Display *display; 
int screen_number; 
ane *count; /* RETURN */ 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 


screen_number 
Specifies the appropriate screen number on the host server. 


count Returns the number of depths. . 


Availability 
Release 4 and later. 


Description 
XListDepths returns the array of depths that are available on the specified screen. If the 
specified screen_number is valid and sufficient memory for the array can be allocated, 
XListDepths sets count to the number of available depths. Otherwise, it does not set 
count and returns NULL. To release the memory allocated for the array of depths, use XF ree. 


Related Commands 
DefaultDepthOfScreen macro, DefaultDepth macro, XListPixmapFormats. 
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Name 
XListExtensions — return a list of all extensions to X supported by Xlib and the server. 


Synopsis 
char **XListExtensions(display, nextensions) 
Display *display; 


int *nextensions; /* RETURN */ 
_ Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 


nextensions Returns the number of extensions in the returned list. 


Description 
XListExtensions lists all the X extensions supported by Xlib and the current server. The 
returned strings will be in ISO LATIN-1 encoding, which means that the first 128 character 
codes are ASCII, and the second 128 character codes are for special characters needed in west- 
ern languages other than English. 


For more information on extensions, see Volume One, Chapter 13, Other Programming Tech- 
niques. 


Related Commands 
XFreeExtensionList, XQueryExtension. 
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Name 
XListFonts — return a list of the available font names. 


Synopsis 
char **XListFonts (display, pattern, maxnames, actual_count) 
Display *display; 
char *pattern; 
int maxnames; 


ine *actual count; /* RETURN */ 
Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
pattern Specifies. the string associated with the font names you want returned. You 


can specify any string, including asterisks (*), and question marks. The aster- 
isk indicates a wildcard for any number of characters and the question mark 
indicates a wildcard for a single character. Upper or lower case is not impor- 
tant. The string should be in ISO LATIN-1 encoding, which means that the 
first 128 character codes are ASCII, and the second 128 character codes are 
for special characters needed in western languages other than English. 


maxnames Specifies the maximum number of names that are to be in the returned list. 
actual _count 
Returns the actual number of font names in the list. 


Description 
XListFonts returns a list of font names that match the string pattern. Each returned font 
name string is terminated by NULL and is lower case. The maximum number of names returned 
in the list is the value you passed to maxnames. The function returns the actual number of 
font names in actual_count. 


If no fonts match the specified names, XListFonts returns NULL. 
The client should call XFreeFontNames when done with the font name list. 


The font search path (the order in which font names in various directories are compared to 
pattern) is set by XSet FontPath. 


For more information on fonts, see Volume One, Chapter 6, Drawing Graphics and Text. 


Related Commands 
XCreateFontCursor, XFreeFont, XFreeFont Info, xXFreeFontNames, XFree- 
FontPath, XGetFontPath, XGetFontProperty, XListFont sWithInfo, XLoad- 
Font, XLoadQueryFont, XQueryFont, XSetFont, XSetFontPath, XUnloadFont. 
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Name 
XListFontsWithInfo — obtain the narnes and information about loaded fonts. 


Synopsis 
char **XListFontsWithInfo (display, pattern, maxnames, 
Count, 20L0) 
Display *display; 


char *pattern; /* null-terminated */ 
int maxnames; 
int *count; --/* RETURN */ 
XFontStruct **info; /* RETURN */ 
Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
pattern Specifies the string associated with the font names you want returned. You 


can specify any string, including asterisks (*) and question marks. The aster- 
isk indicates a wildcard on any number of characters and the question mark 
indicates a wildcard on a single character. Upper or lower case is not impor- 
tant. The string should be in ISO LATIN-1 encoding, which means that the 
first 128 character codes are ASCII, and the second 128 character codes are 
for special characters needed in western languages other than English. 


maxnames Specifies the maximum number of names that are to be in the returned list. 
count Returns the actual number of matched font names. 
info Returns a pointer to a list of font information structures. XListFonts- 


WithInfo provides enough space for maxnames pointers. 


Description 
XListFontsWithInfo returns a list of font names that match the specified pattern anda 
also returns limited information about each font that matches. The list of names is limited to 
the size specified by the maxnames argument. The list of names is in lower case. 


XListFontsWithInfo returns NULL if no matches were found. 


To free the allocated name array, the client should call xFreeFontNames. To free the font 
information array, the client should call XFreeFont Info. 


The information returned for each font is identical to what XQueryFont would return, except 
that the per-character metrics (lbearing, rbearing, width, ascent, descent for 
single characters) are not returned. 


The font search path (the order in which font names in various directories are compared to 
pattern) is set by XSetFontPath. XListFonts returns NULL if no matches were found. 


For more information on fonts, see Volume One, Chapter 6, Drawing Graphics and Text. 
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XListFontsWithinfo 


Structures 
typedef struct { 


XExtData 
Font fid; 
unsigned 
unsigned 
unsigned 
unsigned 
unsigned 
Bool all 
unsigned 
int n_pro 
XFontProp 
XCharStru 
XCharStru 
XCharStru 
int ascen 
int desce 
} kFOntSt ruck: 


*ext_data; 


direction; 
min_char_or byte2; 
max_char or byte2; 
min_bytel; 
max_bytel; 


_chars exist; 


default _char; 
perties; 
*properties; 
ct min_bounds; 
ct max_bounds; 
cG>*perachan; 
te 
ney 


Related Commands 
XCreateFontCursor, XFreeFont, XFreeFontiInfo, XFreeFontNames, XFree- 
FontPath, XGetFontPath, XGetFontProperty, XListFonts, XLoadFont, 
XLoadQueryFont, XQueryFont, XSetFont, XSetFontPath, XUnloadFont. 
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(continued) Xlib — Fonts 
/* hook for extension to hang data */ 
/* Bont, DDPior thas tonk, */ 
/* hint about direction the font is painted */ 
/* first character */ 
/* last character */ 
/* first row that exists */ 
/* last row that exists */ 
/* flag if all characters have nonzero size*/ 
/* char to print for undefined character */ 
/* how many properties there are */ 
/* pointer to array of additional properties*/ 
/* minimum bounds over all existing char*/ 


/* 
/* 
/* 
/* 


minimum bounds over all existing char*/ 
first _char to last char information */ 
logical extent above baseline for spacing */ 
logical descent below baseline for spacing */ 
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Name 
XListHosts — obtain a list of hosts having access to this display. 
Synopsis 
XHostAddress *XListHosts (display, nhosts, state) 
Display *display; 


int *nhosts; /* RETURN */ 
Bool *state; /* RETURN */ 
_ Arguments f 
display Specifies a connection to an X server; returned from XOpenDisplay. 
nhosts Returns the number of hosts currently in the access control list. 
state Returns whether the access control list is currently being used by the server to 
process new connection requests from clients. True if enabled, False if 
disabled. 
Description 


XListHosts returns the current access control list as well as whether the use of the list is 
enabled or disabled. XListHosts allows a program to find out what machines make connec- 
tions, by looking at a list of host structures. This XHostAddress list should be freed when it 
is no longer needed. XListHosts returns NULL on failure. 


For more information on access control lists, see Volume One, Chapter 13, Other Programming 
Techniques. 


Structures 
typedef struct { 
int family; 
int length; 
char *address; 
} XHostAddress; 


Related Commands 


XAddHost, XAddHosts, XDisableAccessControl, XEnableAccessControl, 
XRemoveHost, XRemoveHosts, XSetAccessControl. 
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Name 
XListInstalledColormaps — get a list of installed colormaps. 


Synopsis 
Colormap *XListInstalledColormaps (display, w, num) 
display *display; 
Window w; 


int *num; /* RETURN */ 
Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
w Specifies the ID of the window for whose screen you want the list of currently 
installed colormaps. 
num Returns the number of currently installed colormaps in the returned list. 
Description 


XListInstalledColormaps returns a list of the currently installed colormaps for the 
screen containing the specified window. The order in the list is not significant. There is no dis- 
tinction in the list between colormaps actually being used by windows and colormaps no longer 
in use which have not yet been freed or destroyed. 


XListInstalledColormaps returns None and sets num to zero on failure. 
The allocated list should be freed using XF ree when it is no longer needed. 
For more information on installing colormaps, see Volume One, Chapter 7, Color. 


Errors 
BadwWindow 


Related Commands 
DefaultColormap, DisplayCells, XCopyColormapAndF ree, XCreate- 
Colormap, XFreeColormap, XGetStandardColormap, XInstallColormap, 
XSetStandardColormap, XSetWindowColormap, XUninstallColormap. 
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Name 
XListPixmapFormats — obtain the supported pixmap formats for a given server. 


Synopsis 
XPixmapFormatValues *XListPixmapFormats (display, count) 
Display *display; 


int *count; /* RETURN */ 
- Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
count Returns the number of pixmap formats that are supported by the server. 
Availability 


Release 4 and later. 


Description 
XListPixmapFormats returns an array of XPixmapFormatValues structures that 
describe the types of Z format images that are supported by the specified server. If insufficient 
memory is available, XListPixmapFormats returns NULL. To free the allocated storage for 
the XPixmapFormat Values Structures, use XF ree. 


Structures 
typedef struct { 
int depth; 
int bitseperspixel!; 
int scanline pad; 
} XPixmapFormatValues; 


Related Commands 
XListDepths. 
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Name 
XListProperties — get the property list for a window. 
Synopsis 
Atom *XListProperties (display, w, num_prop) 
Display *display; 
Window w; 


int *num prop; /* RETURN */ 
Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
W Specifies the window whose property list you want. 


num_prop Returns the length of the properties array. 


Description 
XListProperties returns a pointer to an array of atoms for properties that are defined for 
the specified window. XListProperties returns NULL on failure (when window w is inva- 
lid). 
To free the memory allocated by this function, use XF ree. 


For more information, see Volume One, Chapter 10, Interclient Communication. 


Errors 
BadWindow 


Related Commands 
XChangeProperty, XDeleteProperty, XGetAtomName, XGetFontProperty, 
XGetWindowProperty, XInternAtom, XRotateWindowProperties, XSet- 
StandardProperties. 
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Po J XLoadFont 


Name 
XLoadFont — load a font if not already loaded; get font ID. 


Synopsis 
Font XLoadFont (display, name) 
Display *display; 
char *name; 


_ Arguments 

display Specifies a connection to an X server; returned from XOpenDisplay. 

name Specifies the name of the font in a null terminated string. As of Release 4, the 
* and ? wildcards are allowed and may be supported by the server. Upper or 
lower case is not important. The string should be in ISO LATIN-1 encoding, 
which means that the first 128 character codes are ASCII, and the second 128 
character codes are for special characters needed in western languages other 
than English. 

Description | 


XLoadFont loads a font into the server if it has not already been loaded by another client. 
XLoadFont returns the font ID or, if it was unsuccessful, generates a BadName error. When 
the font is no longer needed, the client should call XUnloadFont. Fonts are not associated 
with a particular screen. Once the font ID is available, it can be set in the font member of any 
GC, and thereby used in subsequent drawing requests. 


Font information is usually necessary for locating the text. Call XLoadFontWithInfo to 
get the info at the time you load the font, or call XQueryFont if you used XLoadFont to 
load the font. 


For more information on fonts, see Volume One, Chapter 6, Drawing Graphics and Text. 


Errors 
BadAlloc Server has insufficient memory to store font. 
BadName name specifies an unavailable font. 


Related Commands 
XCreateFontCursor, XFreeFont, XFreeFontInfo, XFreeFontNames, XFree- 
FontPath, XGetFontPath, XGetFontProperty, XListFonts, XListFontswith- 
Info, XLoadQueryFont, XQueryFont, XSetFont, XSetFontPath, XUnloadFont. 
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Name 
XLoadQueryFont — load a font and fill information structure. 


Synopsis 
XFontStruct *XLoadQueryFont (display, name) 
Display *display; 
char *name; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
name Specifies the name of the font. This name is a null terminated string. As of 
Release 4, the * and ? wildcards are allowed and may be supported by the 
server. Upper or lower case is not important. 
Description 


XLoadQueryFont performs a XLoadFont and XQueryFont in a single operation. 
XLoadQueryFont provides the easiest way to get character-size tables for placing a propor- 
tional font. That is, XLoadQueryFont both opens (loads) the specified font and returns a 
pointer to the appropriate XFont Struct structure. If the font does not exist, XLoadQuery- 
Font returns NULL. 


The XFontStruct structure consists of the font-specific information and a pointer to an array 
of XCharStruct structures for each character in the font. 


For more information on fonts, see Volume One, Chapter 6, Drawing Graphics and Text. 


Errors 
BadAlloc server has insufficient memory to store font. 
BadName name specifies an unavailable font. 
Structures 
typedef struct { 
XExtData *ext data; /* hook for extension to hang data */ 
Bonty tac /*s Bonk, 1D) fons thas) font. */ 
unsigned direction; /* hint about direction the font is painted */ 


unsigned min_char or byte2; /* first character */ 
unsigned max_char or byte2; /* last character */ 


unsigned min_bytel; /* first row that exists */ 

unsigned max_bytel; /* last row that exists */ 

Bool Maiieicharseextest), /* flag if all characters have nonzero size*/ 
unsigned default char; /* char to print for undefined character */ 

int n_ properties; /* how many properties there are */ 

XFontProp *properties; /* pointer to array of additional properties*/ 
XCharStruct min_bounds; /* minimum bounds over all existing char*/ 
XCharStruct max_bounds; /* minimum bounds over all existing char*/ 
XCharStruct *per char; /* first_char to last char information */ 

int ascent; /* logical extent above baseline for spacing */ 
int descent; /* logical descent below baseline for spacing */ 


} XFontStruct; 


304 Xlib Reference Manual 


Xlib - Fonts (continued) XLoadQueryFont 


typedef struct { 5 
short lbearing; /* origin‘to left edge of character */ 


short rbearing; /* origin to right edge of character */ 
short width; /* advance to next char’s origin */ 

short ascent; /* baseline to top edge of character */ 
short descent; /* baseline to bottom edge of character */ 


unsigned short attributes; /* per char flags (not predefined) */ 
} XCharStruct; 


Related Commands 
XCreateFontCursor, XFreeFont, XFreeFont Info, XFreeFontNames, XFree- 
FontPath, XGetFontPath, XGetFontProperty, XListFonts, XListFontswWith- 
Info, XLoadFont, XQueryFont, XSetFont, XSetFontPath, XUnloadFont. 
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Name 
XLookUpAssoc — obtain data from an association table. 


Synopsis 
caddr_t XLookUpAssoc (display, table, a2 10) 
Display *display; 
XAssocTable *table; 


MOD 3 2; 
Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
table Specifies the association table. 
xd Specifies the X resource ID. 
Description 


This function is provided for compatibility with X Version 10. To use it you must include the 
file <X11/X10.h> and link with the library -loldx. 


Association tables provide a way of storing data locally and accessing by ID. XLookUp- 
Assoc retrieves the data stored in an XAssocTable by its XID. If the matching XID can be 
found in the table, the routine returns the data associated with it. If the x_id cannot be found 
in the table the routine returns NULL. 


For more information on association tables, see Volume One, Appendix B, X10 Compaitibility. 


Structures 
typedef struct { 
XAssoc *buckets; /* pointer to first bucket in bucket array */ 
ite size; /* table size (number of buckets) */ 


} XAssocTable; 


typedef struct  XAssoc { 


struct XAssoc *next; /* next object in this bucket */ 
struct XAssoc *prev; /* previous object in this bucket */ 
Display *display; /* display which owns the ID */ 
XIDe x eid) /* X Window System ID */ 
char *data; /* pointer to untyped memory */ 

} XAssoc; 


Related Commands 
XCreateAssocTable, XDeleteAssoc, XDestroyAssocTable, XMakeAssoc. 
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Name : 
XLookupColor — get database RGB values and closest hardware-supported RGB values from 
color name. 
Synopsis 


Status XLookupColor (display, cmap, colorname, rgb_db def, 
hardware_def) 
Display *display; 
Colormap cmap; 
char *colorname; 
XColor *rgb_db def, *hardware_def; /* RETURN */ 


Arguments 

display Specifies a connection to an X server; returned from XOpenDisplay. 

cmap Specifies the colormap. 

colorname Specifies a color name string (for example “red”). Upper or lower case 
does not matter. The string should be in ISO LATIN] encoding, which 
means that the first 128 character codes are ASCII, and the second 128 
character codes are for special characters needed in western languages 
other than English. 

rgb_db_ def Returns the exact RGB values for the specified color name from the 


/usr/lib/X11/rgb database. 


hardware _def_ Returns the closest RGB values possible on the hardware. 


Description 
XLookupColor looks up RGB values for a color given the colorname string. It returns both 
the exact color values and the closest values possible on tthe screen specified by cmap. 


XLookupColor returns nonzero if colorname exists in the RGB database or zero if it does 
not exist. 


To determine the exact RGB values, XLookupColor uses a database on the X server. On 
UNIX, this database is /usr/lib/X11/rgb. To read the colors provided by the database on a 
UNIX-based system, see /usr/lib/X11/rgb.txt. The location, name, and contents of this file are 
server-dependent. 


For more information see Volume One, Chapter 7, Color, and Appendix D, The Color Data- 
base, in this volume. 
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Errors 
BadName Color name not in database. 


BadColormap Specified colormap invalid. 


Structures 
typedef struct { 
unsigned long pixel; 
unsigned short red, green, blue; 
char flags; /* DoRed, DoGreen, DoBlue */ 
char pad; 
JeexK COLO 


Related Commands 
BlackPixel, WhitePixel, XAllocColor, XAllocColorCells, XAllocColor- 
Planes, XAllocNamedColor, XFreeColors, XParseColor, XQueryColor, 
XQueryColors, XStoreColor, XStoreColors, XStoreNamedColor. 
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Name . 
XLookupKeysym — get the keysym corresponding to a keycode in structure. 


Synopsis 
KeySym XLookupKeysym(event, index) 
XKeyEvent *event; 
int index; 


Arguments 
event Specifies the KeyP ress or KeyRelease event that is to be used. 
index Specifies which keysym from the list associated with the keycode in the event to 
return. These correspond to the modifier keys, and the symbols ShiftMap- 
Index, LockMapIndex, ControlMapIndex, Mod1lMapIndex, Mod2- 
MapIndex, Mod3MapIndex, Mod4MapIndex, and Mod5MapIndex can be 
used. 
Description 


Given a keyboard event and the index into the list of keysyms for that keycode, XLookup- 
Keysym returns the keysym from the list that corresponds to the keycode in the event. If no 
keysym is defined for the keycode of the event, XLookupKeysym returns NoSymbol. 


Each keycode may have a list of associated keysyms, which are portable symbols representing 
the meanings of the key. The index specifies which keysym in the list is desired, indicating 
the combination of modifier keys that are currently pressed. Therefore, the program must inter- 
pret the state member of the XKeyEvent structure to determine the index before calling 
this function. The exact mapping of modifier keys into the list of keysyms for each keycode is 
server-dependent beyond the fact that the first keysym corresponds to the keycode without 
modifier keys, and the second corresponds to the keycode with Shift pressed. 


XLookupKeysym simply calls XKeycodeToKeysym, using arguments taken from the speci- 
fied event structure. 


Structures 
typedef struct { 

int type; /* of event */ 
unsigned long serial; /* # of last request processed by server */ 
Bool send_event; /* true if this came from a SendEvent request */ 
Display *display; /* display the event was read from */ 
Window window; /* “event" window it is reported relative to */ 
Window root; /* root window that the event occured on */ 
Window subwindow; /* child window */ 
Time time; /* milliseconds */ 
seh xian Ys /* pointer x, y coordinates in event window */ 


int x root, y root; /* coordinates relative to root */ 
unsigned int state; /* key or button mask */ 
unsigned int keycode; /* detail */ 
Bool same screen; /* same screen flag */ 
} XKeyEvent; 
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Related Commands 
XChangeKeyboardMapping, XDeleteModifiermapEntry, XFreeModifiermap, 


XGetKeyboardMapping, XGetModifierMapping, XInsertModifiermapEntry, 
XKeycodeToKeysym, XKeysymToKeycode, XKeysymToString, XLookupString, 
XNewModifierMap, XQueryKeymap, XRebindKeysym, XRefreshKeyboard- 
Mapping, XSetModifierMapping, XStringToKeysym. 
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Name ; 
XLookupString — map a key event to ASCII string, keysym, and ComposeStatus. 


Synopsis 
int XLookupString(event, buffer, num_bytes, keysym, status) 
XKeyEvent *event; 


char *buffer; /* RETURN */ 
int num_bytes; 
KeySym *keysym; /* RETURN */ 
XComposeStatus *status;  /* not implemented */ 
Arguments 
event Specifies the key event to be used. 
buffer Returns the resulting string. 
num_bytes Specifies the length of the buffer. No more than num_bytes of translation 
are returned. 
keysym If this argument is not NULL, it specifies the keysym ID computed from the 
event. 
status Specifies the XCompose structure that contains compose key state informa- 


tion and that allows the compose key processing to take place. This can be 
NULL if the caller is not interested in seeing compose key sequences. Not 
implemented in X Consortium Xlib through Release 4. 


Description 
XLookupSt ring gets an ASCII string and a keysym that are currently mapped to the keycode 
in a KeyPress or KeyRelease event, using the modifier bits in the key event to deal with 
shift, lock and control. The XLookupString return value is the length of the translated 
string and the string’s bytes are copied into buffer. The length may be greater than 1 if the 
event’s keycode translates into a keysym that was rebound with XRebindKeysym. 


The compose status is not implemented in any release of the X Consortium version of Xlib 
through Release 4. 


In Release 4, XLookupSt ring implements the new concept of keyboard groups. Keyboard 
groups support having two complete sets of keysyms for a keyboard. Which set will be used 
can be toggled using a particular key. This is implemented by using the first two keysyms in 
the list for a key as one set, and the next two keysyms as the second set. For more information 
on keyboard groups, see Volume One, Appendix G, Release Notes. 


For more information on using XLookupSt ring in general, see Volume One, Chapter 9, The 
Keyboard and Pointer. 


Structures 
/* 
* Compose sequence status structure, used in calling XLookupString. 


*/ : 
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(continued) Xlib — Keyboard 


typedef struct XComposeStatus { 


char *compose ptr; 
int chars_matched; 
} XComposeStatus; 


typedef struct { 
int type; 
unsigned long serial; 


/* 
/* 


/* 


state table pointer */ 
match state */ 


of event */ 


/* # of last request processed by server */ 


Bool send_event; /* true if this came from a SendEvent request */ 


Display *display; 
Window window; 
Window root; 
Window subwindow; 
Time time; 
CEI pa 
lice Xe eOOw mVvaEGOOk, 
unsigned int state; 
unsigned int keycode; 
Bool same_screen; 

} XKeyEvent; 


Related Commands 
XChangeKeyboardMapping, XDeleteModifiermapEntry, XFreeModifiermap, 
XGetKeyboardMapping, XGetModifierMapping, XInsertModifiermapEntry, 
XKeycodeToKeysym, XKeysymToKeycode, XKeysymToString, XLookupKeysym, 
XNewModifierMap, XQueryKeymap, XRebindKeySym, XRef reshKeyboard- 
Mapping, XSetModifierMapping, XStringToKeysym. 
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/* 
/* 
/* 
/* 
/* 
/* 
/* 
/* 
/* 
/* 


Display the event was read from */ 

"event" window it is reported relative to */ 
root window that the event occured on */ 
child window */ 

milliseconds */ 

pointer x, y coordinates in event window */ 
coordinates relative to root */ 

key or button mask */ 

detail */ 

same screen flag */ 
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Name : 
XLowerWindow — lower a window in the stacking order. 
Synopsis 
XLowerWindow (display, w) 
Display *display; 
Window w; 


Arguments 
display Specifies a connection to-an X server; returned from XOpenDisplay. 
w Specifies the ID of the window to be lowered. 


Description 
XLowerWindow lowers a window in the stacking order of its siblings so that it does not 
obscure any sibling windows. If the windows are regarded as overlapping sheets of paper 
stacked on a desk, then lowering a window is analogous to moving the sheet to the bottom of 
the stack, while leaving its x and y location on the desk constant. Lowering a mapped window 
will generate exposure events on any windows it formerly obscured. 


If the override redirect attribute of the window (see Chapter 4, Window Attributes) is 
False and the window manager has selected Subst ructureRedirectMask on the par- 
ent, then a ConfigureRequest event is sent to the window manager, and no further pro- 
cessing is performed. Otherwise, the window is lowered to the bottom of the stack. 


LeaveNotify events are sent to the lowered window if the pointer was inside it, and 
EntexrNotify events are sent to the window which was immediately below the lowered win- 
dow at the pointer position. 


For more information, see Volume One, Chapter 14, Window Management. 


Errors 
BadWindow 


Related Commands 
XCirculateSubwindows, XCirculateSubwindowsDown, XCirculate- 
SubwindowsUp, XConfigureWindow, XMoveResizeWindow, XMoveWindow, 
XQueryTree, XRaiseWindow, XReparentWindow, XResizeWindow, XRestack- 
Windows. 
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Name 


XMakeAssoc — create an entry in an association table. 


Synopsis 


XMakeAssoc (display, table, x_id, data) 


Display *display; 
XAssocTable *table; 
SLD n.d 

caddr_t data; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
table Specifies the association table in which an entry is to be made. 
id Specifies the X resource ID. 
data Specifies the data to be associated with the X resource ID. 
Description 


XMakeAssoc inserts data into an XAssocTable keyed on an XID. Association tables allow 
you to easily associate data with resource ID’s for later retrieval. Association tables are local, 


accessible only by this client. 


This function is provided for compatibility with X Version 10. To use it you must include the 
file <XJ1/X10.h> and link with the library -loldX. 


Data is inserted into the table only once. Redundant inserts are meaningless and cause no prob- 
lems. The queue in each association bucket is sorted from the lowest XID to the highest XID. 


For more information, see Volume One, Appendix B, X/0 Compatibility. 


Structure 
typedef struct { 
XAssoc *buckets; /* 
int size; [x 
} XAssocTable; 


typedef struct _XAssoc { 


struct XAssoc *next; /* 

SULUCE = AASSOC == pEeV si /* 

Display *display; Vee 

RID ex ids le 

char *data; Hae 
} XAssoc; 


Related Commands 


pointer to first bucket in bucket array */ 
table size (number of buckets) */ 


next object in this bucket */ 
previous object in this bucket */ 
display which owns the ID */ 

X Window System ID */ 

pointer to untyped memory */ 


xCreateAssocTable, XDeleteAssoc, XDest royAssocTable, XLookUpAssoc. 
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Name , 
XMapRaised — map a window on top of its siblings. 


Synopsis 
XMapRaised (display, w) 
Display *display; 
Window w; 


Arguments : 
display Specifies a connection to an X server; returned from XOpenDisplay. 
w Specifies the window ID of the window to be mapped and raised. 
Description 


XMapRaised marks a window as eligible to be displayed. It will actually be displayed if its 
ancestors are mapped, it is on top of sibling windows, and it is not obscured by unrelated win- 
dows. XMapRaised is similar to XMapWindow, except it additionally raises the specified 
window to the top of the stack among its siblings. Mapping an already mapped window with 
XMapRaised raises the window. See XMapWindow for further details. 


For more information, see Volume One, Chapter 14, Window Management. 


Errors 
BadWindow 


Related Commands 
XMapSubwindows, XMapWindow, XUnmapSubwindows, XUnmapWindow. 
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XMapSu bwindows Xlib — Window Mapping — 


Name 
XMapSubwindows — map all subwindows of window. 


Synopsis 
XMapSubwindows (display, w) 
Display *display; 
Window w; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
w Specifies the ID of the window whose subwindows are to be mapped. 
Description 


XMapSubwindows maps all subwindows of a window in top-to-bottom stacking order. 
XMapSubwindows also generates an Expose event on each newly displayed window. This 
is much more efficient than mapping many windows one at a time, as much of the work need 
only be performed once for all of the windows rather than for each window. XMap- 
Subwindows is not recursive — it does not map the subwindows of the subwindows. 


For more information, see Volume One, Chapter 14, Window Management. 


Errors 
BadWindow 


Related Commands 
XMapRaised, XMapWindow, XUnmapSubwindows, XUnmapWindow. 
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— Xlib - Window Mapping —————— XMapWindow 


Name 
XMapWindow — map a window. 


Synopsis 
XMapWindow (display, w) 
Display *display; 
Window w; 


Arguments a 
display Specifies a connection to an X server; returned from XOpenDisplay. 
w Specifies the ID of the window to be mapped. 

Description 


XMapWindow maps a window, making it eligible for display depending on its stacking order 
among its siblings, the mapping status of its ancestors, and the placement of other visible win- 
dows. If all the ancestors are mapped, and it is not obscured by siblings higher in the stacking 
order, the window and all of its mapped subwindows are displayed. 


Mapping a window that has an unmapped ancestor does not display the window but marks it as 
eligible for display when its ancestors become mapped. Mapping an already mapped window 
has no effect (it does not raise the window). 


Note that for a top-level window, the window manager may intervene and delay the mapping of 
the window. The application must not draw until it has received an Expose event on the win- 
dow. 


If the window is opaque, XMapWindow generates Expose events on each opaque window 
that it causes to become displayed. If the client first maps the window, then paints the window, 
then begins processing input events, the window is painted twice. To avoid this, the client 
should use either of two strategies: 


1. Map the window, call XSelect Input for exposure events, wait for the first Expose 
event, and repaint each window explicitly. 


2. Call XSelectInput for exposure events, map, and process input events normally. 
Exposure events are generated for each window that has appeared on the screen, and the 
client’s normal response to an Expose event should be to repaint the window. 


The latter method is preferred as it usually leads to simpler programs. If you fail to wait for the 
Expose event in the first method, it can cause incorrect behavior with certain window manag- 
ers that intercept the request. 


Errors 
BadWindow 


Related Commands 
XMapRaised, XMapSubwindows, XUnmapSubwindows, XUnmapWindow. 
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Name 
XMaskEvent — remove the next event that matches mask. 


Synopsis 
XMaskEvent (display, event_mask, rep) 
Display *display; 
long event_mask; 


XEvent *rep; /* RETURN */ 
Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 


event_mask Specifies the event mask. See XSelect Input for a complete list of the 
event mask symbols that can be ORed together. 


rep Returns the event removed from the input queue. 


Description 
XMaskEvent removes the next event in the queue which matches the passed mask. The event 
is copied into an XEvent supplied by the caller. Other events in the queue are not discarded. 
If no such event has been queued, XMaskEvent flushes the request buffer and waits until one 
is received. Use XCheckMaskEvent if you do not wish to wait. 


XMaskEvent never returns MappingNotify, SelectionClear, SelectionNotify, 
or SelectionRequest events. When you specify ExposureMask it will return 
GraphicsExpose or NoExpose events if those occur. 


Related Commands 
QLength, XAllowEvents, XCheckIfEvent, XCheckMaskEvent, XCheckTyped- 
Event, XCheckTypedWindowEvent, XCheckWindowEvent, XEventsQueued, 
XGet InputFocus, XGetMotionEvents, XIfEvent, XNextEvent, XPeekEvent, 
XPeekIfEvent, XPending, XPutBackEvent, XSelect Input, XSendEvent, XSet- 
InputFocus, XSynchronize, XWindowEvent. 
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Name 
XMatchVisualInfo — obtain the visual information that matches the desired depth and class. 


Synopsis 
Status XMatchVisualInfo (display, screen, depth, class, vinfo) 
Display *display; 
int screen; 


int depth; 
ant (class; = 
XVisualiInfo *vinfo; /* RETURN */ 
Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
screen Specifies the screen. 
depth Specifies the desired depth of the visual. 
class — Specifies the desired class of the visual, such as PseudoColor or True- 
CoLor, 
vinfo Returns the matched visual information. 
Description 


XMatchVisualInfo returns the visual information for a visual supported on the screen that 
matches the specified depth and class. Because multiple visuals that match the specified 
depth and class may be supported, the exact visual chosen is undefined. 


If a visual is found, this function returns a nonzero value and the information on the visual is 
returned to vinfo. Ifa visual is not found, it returns zero. 


For more information on visuals, see Volume One, Chapter 7, Color. 


Structures 

typedef struct { 
Visual *visual; 
VisualID visualid; 
int screen; 
unsigned int depth; 
int class; 
unsigned long red mask; 
unsigned long green_mask; 
unsigned long blue_mask; 
int colormap_size; 
int, bits per prob; 

} XVisuallInfo; 


Related Commands 
- DefaultVisual, XGetVisualInfo. 
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Name 
XMoveResizeWindow — change the size and position of a window. 


Synopsis 
XMoveResizeWindow (display, w, xX, Yy, width, height) 
Display *display; 
Window w; 
SRY ee ar 
unsigned int width, height; 


Arguments 


display Specifies a connection to an X server; returned from XOpenDisplay. 
w Specifies the ID of the window to be reconfigured. 
x Specify the new x and y coordinates of the upper-left pixel of the window’s bor- 
y der, relative to the window’s parent. 
width Specify the new width and height in pixels. These arguments define the interior 
height size of the window. 

Description 


XMoveResizeWindow moves or resizes a window or both. XMoveResizeWindow does 
not raise the window. Resizing a mapped window may lose its contents and generate an 
Expose event on that window depending on the bit_gravity attribute. Configuring a win- 
dow may generate exposure events on windows that the window formerly obscured, depending 
on the new size and location parameters. 


If the override redirect attribute of the window is False (see Volume One, Chapter 4, 
Window Attributes) and the window manager has selected Subst ructureRedirectMask 
on the parent, then a ConfigureRequest event is sent to the window manager, and no fur- 
ther processing is performed. 


If the client has selected StructureNotifyMask on the window, then a Configure- 
Notify event is generated after the move and resize takes place, and the event will contain 
the final position and size of the window. 


Errors 
BadValue 
BadWindow 


Related Commands 
XCirculateSubwindows, XCirculateSubwindowsDown, XCirculate- 
SubwindowsUp, XConfigureWindow, XLowerWindow, XMoveWindow, XQuery- 
Tree, XRaiseWindow, XReparentWindow, XResizeWindow, XRestackWindows. 
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Name , 
XMoveWindow — move a window. ‘ 


Synopsis 
XMoveWindow (display, w, x, y) 
Display *display; 
Window w; 
ant x, ys 


_ Arguments : 
display Specifies a connection to an X server; returned from XOpenDisplay. 
w Specifies the ID of the window to be moved. 
x Specify the new x and y coordinates of the upper-left pixel of the window’s bor- 
y der (or of the window itself, if it has no border), relative to the window’s parent. 
Description 


XMoveWindow changes the position of the origin of the specified window relative to its par- 
ent. XMoveWindow does not change the mapping state, size, or stacking order of the window, 
nor does it raise the window. Moving a mapped window will lose its contents if: 


° Its background_pixmap attribute is ParentRelative. 
° The window is obscured by nonchildren and no backing store exists. 


If the contents are lost, exposure events will be generated for the window and any mapped 
subwindows. Moving a mapped window will generate exposure events on any formerly 
obscured windows. 


If the override redirect attribute of the window is False (see Volume One, Chapter 4, 
Window Attributes) and the window manager has selected Subst ructureRedirectMask 
on the parent, then a ConfigureRequest event is sent to the window manager, and no fur- 
ther processing is performed. 


If the client has selected St ructureNotifyMask on the window, then a Configure- 
Notify event is generated after the move takes place, and the event will contain the final posi- 
tion of the window. 


Errors 
BadWindow 


Related Commands 
XCirculateSubwindows, XCirculateSubwindowsDown, XCirculate- 
SubwindowsUp, XConfigureWindow, XLowerWindow, XMoveResizeWindow, 
XQueryTree, XRaiseWindow, XReparentWindow, XResizeWindow, XRestack- 
Windows. 
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Name 
XNewModifiermap — create a keyboard modifier mapping structure. 


Synopsis 
XModifierKeymap *XNewModifiermap (max_keys_per_mod) 
int max_keys_per_mod; 


Arguments 
max_keys_per_mod 
Specifies the maximum number of keycodes assigned to any of the modifiers in the 
map. 


Description 
XNewModifiermap returns a XModifierKeymap structure and allocates the needed space. 
This function is used when more than one .XModifierKeymap structure is needed. 
max_keys_per_mod depends on the server and should be gotten from the XModifier- 
Keymap returned by XGetModifierMapping. 


For more information on keyboard preferences, see Volume One, Chapter 9, The Keyboard and 


Pointer. 
Structures 
typedef struct { 
int max_keypermod; /* server’s max number of keys per modifier */ 
KeyCode *modifiermap; /* An 8 by max _keypermod array 


* of the modifiers */ 
} XModifierKeymap; 


Related Commands 
XChangeKeyboardMapping, XDeleteModifiermapEntry, XFreeModifiermap, 
XGetKeyboardMapping, XGetModifierMapping, XInsertModifiermapEntry, 
XKeycodeToKeysym, XKeysymToKeycode, XKeysymToSt ring, XLookupKeysym, 
XLookupSt ring, XQueryKeymap, XRebindKeysym, XRefreshKeyboardMapping, 
XSetModifierMapping, XStringToKeysym. 
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Name 
XNextEvent — get the next event of any type or window. 


Synopsis 
XNextEvent (display, report) 
Display *display; 


XEvent *report; /* RETURN */ 
Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
report Returns the event removed from the event queue. 
Description 


XNextEvent removes an event from the head of the event queue and copies it into an 
XEvent structure supplied by the caller. If the event queue is empty, XNextEvent flushes 
the request buffer and waits (blocks) until an event is received. Use XCheckMaskEvent or 
XCheckIfEvent if you do not want to wait. 


For more information, see Volume One, Chapter 8, Events. 


Related Commands 
QLength, XAllowEvents, XCheckIfEvent, XCheckMaskEvent, XCheckTyped- 
Event, XCheckTypedWindowEvent, XCheckWindowEvent, XEventsQueued, 
XGet InputFocus, XGetMotionEvents, XIfEvent, XMaskEvent, XPeekEvent, 
XPeekIfEvent, XPending, XPutBackEvent, XSelectInput, XSendEvent, XSet- 
InputFocus, XSynchronize, XWindowEvent. 
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Name 
XNoOp — send a NoOp to exercise connection with the server. 


Synopsis 
XNoOp (display) 
Display *display; 


Arguments 

display Specifies a connection to an X server; returned from XOpenDisplay. 
Description 

XNoOp sends a NoOperation request to the X server, thereby exercising the connection. 


This request can be used to measure the response time of the network connection. XNoOp does 
not flush the request buffer. 


Related Commands 
DefaultScreen, XCloseDisplay, XFree, XOpenDisplay. 
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Name 
XOffsetRegion — change offset of a region. ‘ 


Synopsis 
XOffsetRegion(r, dx, dy) 
Region r; 
LAE Sak, dy 


_ Arguments 
z Specifies the region. ii 
dx Specify the amount to move the specified region relative to the origin of all 
dy regions. 
Description 
XOffsetRegion changes the offset of the region the specified amounts in the x and y direc- 
tions. 


Regions are located using an offset from a point (the region origin) which is common to all 
regions. It is up to the application to interpret the location of the region relative to a drawable. 
If the region is to be used as aclip_mask by calling XSetRegion, the upper-left corner of 
the region relative to the drawable used in the graphics request will be at (xoffset + 
clip x origin, yoffset + clip _y origin), where xoffset and yoffset are 
the offset of the region and clip x origin and clip _y origin are components of the 
GC used in the graphics request. 


Structures 
Region is a pointer to an opaque structure type. 


Reiated Commands 
XClipBox, XCreateRegion, XDest royRegion, XEmpt yRegion, XEqualRegion, 
XIntersectRegion, XPoint InRegion, XPolygonRegion, XRectInRegion, 
XSetRegion, XShrinkRegion, XSubtractRegion, XUnionRectWithRegion, 
XUnionRegion, XXorRegion. 
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XOpenDisplay Xlib - HouseKeeping — 


Name 


XOpenDisplay — connect a client program to an X server. 


Synopsis 


Display *XOpenDisplay (display_name) 
char *display name; 


Arguments 


display _name 
Specifies the display name, which determines the server to connect to and the 
communications domain to be used. See Description below. 


Description 


326 


The XOpenDisplay routine connects the client to the server controlling the hardware display 
through TCP, or UNIX or DECnet streams. 


If display_name is NULL, the value defaults to the contents of the DISPLAY environment 
variable on UNIX-based systems. On non-UNIX-based systems, see that operating system’s 
Xlib manual for the default display name. The display name or DISPLAY environment 
variable is a string that has the format hostname:server or  host- 
name: server.screen. For example, frog:0.2 would specify screen 2 of server 0 on the 
machine frog. 


hostname _ Specifies the name of the host machine on which the display is physically con- 
nected. You follow the hostname with either a single colon (:) or a double colon 
(::), which determines the communications domain to use. Any or all of the 
communication protocols can be used simultaneously on a server built to sup- 
port them (but only one per client). 


° If hostname is a host machine name and a single colon (:) separates the 
hostname and display number, XOpenDisplay connects the hardware 
display to TCP streams. In Release 4 and later, the string “unix” is no 
longer required and the string “:o” connects the local server. 


° If hostname is “unix” and a single colon (:) separates it from the display 
number, XOpenDisplay connects the hardware display to UNIX domain 
IPC streams. In Release 4, the string “unix” should be omitted. 


° If hostname is a host machine name and a double colon (::) separates 
the hostname and display number, XOpenDisplay connects with the 
server using DECnet streams. To use DECnet, however, you must build 
all software for DECnet. A single X server can accept both TCP and 
DECnet connections if it has been built for DECnet. 


server Specifies the number of the server on its host machine. This display number 


may be followed by a period (.). A single CPU can have more than one display; 
the displays are numbered starting from 0. 
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screen Specifies the number of the default screen on server. Multiple screens can be 
connected to (controlled by) a single X server, but they are used as a single dis- 
play by a single user. screen merely sets an internal variable that is returned 
by the DefaultScreen macro. If screen is omitted, it defaults to 0. 


If successful, XOpenDisplay returns a pointer toa Display. This structure provides many 
of the specifications of the server and its screens. If XOpenDisplay does not succeed, it 
returns a NULL. 


After a successful call to XOpenDisplay, all of the screens on the server may be used by the 
application. The screen number specified in the display name argument serves only to 
specify the value that will be returned by the DefaultScreen macro. After opening the dis- 
play, you can use the ScreenCount macro to determine how many screens are available. 
Then you can reference each screen with integer values between 0 and the value returned by 
(ScreenCount -1). 


For more information, see Volume One, Chapter 2, X Concepts, and Chapter 3, Basic Window 
Program. 


Related Commands 
DefaultScreen, XCloseDisplay, XFree, XNoOp. 
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Name 
XParseColor — look up RGB values from ASCII color name or translate hexadecimal value. 


Synopsis 
Status XParseColor(display, colormap, spec, rgb_db def) 
Display *display; 
Colormap colormap; 
Ghar ASpec; 


KCOlor.* rgb. db ,déf; /* RETURN */ 
Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
colormap Specifies.a colormap. This argument is required but is not used. The same 


code is used to process XParseColor and XLookupColor, but only 
XLookupColor returns the closest values physically possible on the screen 
specified by colormap. 


spec Specifies the color specification, either as a color name or as hexadecimal 
coded in ASCII (see below). Upper or lower case does not matter. The string 
must be null-terminated, and should be in ISO LATIN-1 encoding, which 
means that the first 128 character codes are ASCII, and the second 128 char- 
acter codes are for special characters needed in western languages other than 
English. 


rgb_db_def_ Returns the RGB values corresponding to the specified color name or hexade- 
cimal specification, and sets its DoRed, DoGreen and DoB1ue flags. 


Description 

XParseColor returns the RGB values corresponding to the English color name or hexade- 
cimal values specified, by looking up the color name in the color database, or translating the 
hexadecimal code into separate RGB values. It takes a string specification of a color, typically 
from a command line or XGetDefault option, and returns the corresponding red, green, and 
blue values, suitable for a subsequent call to XAllocColor or XStoreColor. spec can be 
given either as an English color name (as in XAllocNamedColor) or as an initial sharp sign 
character followed by a hexadecimal specification in one of the following formats: 


#RGB (one character per color) 
#RRGGBB (two characters per color) 
#RRRGGGBBB (three characters per color) 
#RRRRGGGGBBBB (four characters per color) 


where R, G, and B represent single hexadecimal digits (upper or lower case). 


The hexadecimal strings must be null-terminated so that XParseColor knows when it has 
reached the end. When fewer than 16 bits each are specified, they represent the most signifi- 
cant bits of the value. For example, #3a7 is the same as #3000a0007000. 
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This routine will fail and return a Status of zero if the initial character is a sharp sign but the 
string otherwise fails to fit one of the above formats, or if the initial character is not a sharp sign 
and the named color does not exist in the server’s database. 


Status is zero on failure, nonzero on success. 


For more information, see Volume One, Chapter 7, Color. 


Structures 
typedef struct { 
unsigned long pixel; . 
unsigned short red, green, blue; 
char flags; 
char pad; 
Pe ACOMor, 


/* DoRed, DoGreen, DoBlue */ 


Errors 
BadColormap 


Related Commands 


BlackPixel, WhitePixel, XAllocColor, XAllocColorCells, XAllocColor- 
Planes, XAllocNamedColor, XFreeColors, XLookupColor, XQueryColor, 
XQueryColors, XStoreColor, XStoreColors, XStoreNamedColor. 
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Name 
XParseGeometry — generate position and size from standard window geometry string. 


Synopsis 
int XParseGeometry (parsestring, x, y, width, height) 
char *parsestring; 


int’ *x,- *y; /* RETURN */ 
unsigned int *width, *height; /* RETURN */ 
Arguments 
parsestring Specifies the string you want to parse. 
x Return the x and y coordinates (offsets) from the string. 
9g 
width Return the width and height in pixels from the string. 
height ‘ 
Description 


By convention, X applications provide a geometry command line option to indicate window 
size and placement. XParseGeomet ry makes it easy to conform to this standard because it 
allows you to parse the standard window geometry string. Specifically, this function lets you 
parse strings of the form: 


=<width>x<height>{+-}<xoffset>{+-}<yoffset> 


The items in this string map into the arguments associated with this function. (Items enclosed 
in <>’are integers and items enclosed in { } are a set from which one item is allowed. Note that 
the brackets should not appear in the actual string.) 


XParseGeometry returns a bitmask that indicates which of the four values (width, 
height, xoffset, and yoffset) were actually found in the string, and whether the x and y 
values are negative. The bits are represented by these constants: XValue, YValue, Width- 
Value, HeightValue, XNegative, and YNegative, and are defined in <XJ1/Xutil.h>. 
For each value found, the corresponding argument is updated and the corresponding bitmask 
element set; for each value not found, the argument is left unchanged, and the bitmask element 
is not set. 


For more information, see Volume One, Chapter 11, Managing User Preferences. 


Related Commands 
XGeometry, XTranslateCoordinates, XWMGeomet ry. 
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Name 
XPeekEvent — get an event without removing it from the queue. 


Synopsis 
XPeekEvent (display, report) 
Display *display; 


XEvent *report; /* RETURN */ 
-Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
report Returns the event peeked from the input queue. 
Description 


XPeekEvent peeks at an input event from the head of the event queue and copies it into an 
XEvent supplied by the caller, without removing it from the input queue. If the queue is 
empty, XPeekEvent flushes the request buffer and waits (blocks) until an event is received. 
If you do not want to wait, use the QLength macro to determine if there are any events to peek 
at, or use XPeekIfEvent. XEventsQueued can perform the function of either QLength 
or XPending and more. 


For more information, see Volume One, Chapter 8, Events. 


Related Commands 
QLength, XAllowEvents, XCheckIfEvent, XCheckMaskEvent, XCheckTyped- 
Event, XCheckTypedWindowEvent, XCheckWindowEvent, XEventsQueued, 
XGet InputFocus, XGetMotionEvents, XIfEvent, XMaskEvent, XNextEvent, 
XPeekIfEvent, XPending, XPutBackEvent, XSelectInput, XSendEvent, XSet- 
InputFocus, XSynchronize, XWindowEvent. 
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Name 
XPeekIfEvent — get an event matched by predicate procedure without removing it from the 
queue. 
Synopsis 


XPeekIfEvent (display, event, predicate, args) 
Display *display; 
XEvent *event; /* RETURN */ 
Bool (*predicate) (); 
char *args; 


Arguments 
display Specifies.a connection to an X server; returned from XOpenDisplay. 
event Returns the matched event. 


predicate — Specifies the procedure to be called to determine if each event that arrives in 
the queue is the desired one. 


args Specifies the user-specified arguments that will be passed to the predicate 
procedure. 


Description 
XPeekIfEvent returns an event only when the specified predicate procedure returns True 
for the event. The event is copied into event but not removed from the queue. The specified 
predicate is called each time an event is added to the queue, with the arguments display, 
event, and arg. 


XPeekIfEvent flushes the request buffer if no matching events could be found on the queue, 
and then waits for the next matching event. 


For more information, see Volume One, Chapter 8, Events. 


Related Commands 
QLength, XAllowEvents, XCheckIfEvent, XCheckMaskEvent, XCheckTyped- 
Event, XCheckTypedWindowEvent, XCheckWindowEvent, XEvent sQueued, 
XGet InputFocus, XGetMotionEvents, XIfEvent, XMaskEvent, XNextEvent, 
XPeekEvent, XPending, XPutBackEvent, XSelectInput, XSendEvent, XSet- 
InputFocus, XSynchronize, XWindowEvent. 
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Name 
XPending — flush the request buffer and return the number of pending input events. 


Synopsis 
int XPending (display) 
Display *display; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 


Description 
XPending returns the number of input events that have been received by Xlib from the server, 
but not yet removed from the queue. If there are no events on the queue, XPending flushes 
the request buffer, and returns the number of events transferred to the input queue as a result of 
the flush. 


The QLength macro returns the number of events on the queue, but without flushing the 
request buffer first. 


For more information, see Volume One, Chapter 8, Events. 


Related Commands 
QLength, XAllowEvents, XCheckIifEvent, XCheckMaskEvent, XCheckTyped- 
Event, XCheckTypedWindowEvent, XCheckWindowEvent, XEvent sQueued, 
XGet InputFocus, XGetMotionEvents, XIfEvent, XMaskEvent, XNextEvent, 
XPeekEvent, XPeekIfEvent, XPutBackEvent, XSelectInput, XSendEvent, 
XSet InputFocus, XSynchronize, XWindowEvent. 
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Name 
Xpermalloc — allocate memory never to be freed. 


Synopsis 
char *Xpermalloc (size) 
unsigned int size; 


Arguments 
size Specifies the size in bytes of the space to be allocated. This specification is 
rounded to the nearest 4-byte boundary. 
Description 


Xpermalloc allocates some memory that will not be freed until the process exits. Xperm- 
alloc is used by some toolkits for permanently allocated storage and allows some perfor- 
mance and space savings over the completely general memory allocator. 
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Name 
XPointInRegion — determine if a point is inside a region. 
Synopsis 
Bool XPointInRegion(r, x, y) 
Region r; 
int xten Vi 


Arguments 
xr Specifies the region. 
x Specify the x and y coordinates of the point relative to the region’s origin. 
vi 
Description 


XPointInRegion returns True if the point x, y is contained in the region r. A point 
exactly on the boundary of the region is considered inside the region. 


Regions are located using an offset from a point (the region origin) which is common to all 
regions. It is up to the application to interpret the location of the region relative to a drawable. 


For more information on regions, see Volume One, Chapter 6, Drawing Graphics and Text. 


Structures 
Region is a pointer to an opaque structure type. 


Related Commands 
XClipBox, XCreateRegion, XDest royRegion, XEmptyRegion, XEqualRegion, 
XIntersectRegion, XOffsetRegion, XPolygonRegion, XRect InRegion, XSet- 
Region, XShrinkRegion, XSubt ractRegion, XUnionRectWithRegion, XUnion- 
Region, XXorRegion. 
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Name 
XPolygonRegion — generate a region from points. 


Synopsis 
Region XPolygonRegion (points, n, fill_rule) 
XPoint points[]; 
Di temerayy 
ont £20) rule; 


Arguments 
points Specifies a pointer to an array of points. 
n Specifies the number of points in the polygon. 


fill _rule Specifies whether areas overlapping an odd number of times should be part of 
the region (WindingRule) or not part of the region (EvenOddRule). See 
Volume One, Chapter 5, The-Graphics Context, for a description of the fill 
rule. 


Description 
XPolygonRegion creates a region defined by connecting the specified points, and returns a 
pointer to be used to refer to the region. 


Regions are located relative to a point (the region origin) which is common to all regions. In 
XPolygonRegion, the coordinates specified in points are relative to the region origin. By 
specifying all points relative to the drawable in which they will be used, the region origin can 
be coincident with the drawable origin. It is up to the application whether to interpret the loca- 
tion of the region relative to a drawable or not. 


If the region is to be used asa clip _mask by calling xSet Region, the upper-left corner of 
the region relative to the drawable used in the graphics request will be at (xoffset + 
clip _x origin, yoffset + clip _y origin), where xoffset and yoffset are 
the offset of the region (if any) and clip_x originand clip y origin are elements of 
the GC used in the graphics request. The f£i11_rulecan be either of these values: 


° EvenOddRule Areas overlapping an odd number of times are not part of the region. 
e WindingRule Overlapping areas are always filled. 
For more information on structures, see Volume One, Chapter 6, Drawing Graphics and Text. 


Structures 
Region is a pointer to an opaque structure type. 


Related Commands 
XClipBox, XCreateRegion, XDestroyRegion, XEmpt yRegion, XEqualRegion, 
xIntersectRegion, xXOffsetRegion, XPoint InRegion, XRect InRegion, XSet- 
Region, XShrinkRegion, XSubt ractRegion, XUnionRectWithRegion, XUnion- 
Region, XXorRegion. 
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Name ‘ 
XPutBackEvent — push an event back on the input queue. 


Synopsis 
XPutBackEvent (display, event) 
Display *display; 
XEvent *event; 


Arguments i: 
display Specifies a connection to an X server; returned from XOpenDisplay. 
event Specifies a pointer to the event to be requeued. 

Description 


XPutBackEvent pushes an event back onto the head of the current display’s input queue (so 
that it would become the one returned by the next XNextEvent call). This can be useful if 
you have read an event and then decide that you’d rather deal with it later. There is no limit to 
how many times you can call XPut BackEvent in succession. 


For more information, see Volume One, Chapter 8, Events. 


Related Commands 
QLength, XAllowEvents, XCheckIfEvent, XCheckMaskEvent, XCheckTyped- 
Event, XCheckTypedWindowEvent, XCheckWindowEvent, XEvent sQueued, 
XGet InputFocus, XGetMotionEvents, XIfEvent, XMaskEvent, XNextEvent, 
XPeekEvent, XPeekIfEvent, XPending, XSelectInput, XSendEvent, XSet- 
InputFocus, XSynchronize, XWindowEvent. 
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Name 
XPutImage — draw an image on a window or pixmap. 


Synopsis 
XPutImage (display, drawable, gc, image, Src_X, SIrc_y, 
dst. x, dst_y, width, height) 
Display *display; 
Drawable drawable; 
Ge gc'; 
XImage *image; 
int “sre xX, Src-y; 
int dst x, dst “y; 
unsigned int width, height; 


Arguments : 
display Specifies a connection to an X server; returned from XOpenDisplay. 


drawable Specifies the drawable. 


gc Specifies the graphics context. 
image Specifies the image you want combined with the rectangle. 
SrC_x Specify the coordinates of the upper-left corner of the rectangle to be copied, 
Src_y relative to the origin of the image. 
dst_x Specify the x and y coordinates, relative to the origin of the drawable, where 
astry the upper-left corner of the copied rectangle will be placed. 
width Specify the width and height in pixels of the rectangular area to be copied. 
height 

Description 


XPutImage draws a section of an image on a rectangle in a window or pixmap. The section 
of the image is defined by src_x, src_y, widthand height. 


There is no limit to the size of image that can be sent to the server using XPut Image. XPut- 
Image automatically decomposes the request to make sure that the maximum request size of 
the server is not exceeded. 


XPut Image uses these graphics context components: function, plane_mask, subwin- 
dow_mode, clip x origin, clip _y origin, and clip _mask. This function also 
uses these graphics context mode-dependent components: foreground and background. 


If an XYBitmap format image is used, then the depth of drawable must be 1, otherwise a 
BadMatch error is generated. The foreground pixel in gc defines the source for bits set to 
one in the image, and the background pixel defines the source for the bits set to zero. 


For XYPixmap and ZPixmap format images, the depth of the image must match the depth of 
drawable. 
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(continued) XPutiImage 


Structures 
typedef struct XImage { 
int width, height; /* size of image */ 
int xoffset; /* number of pixels offset in x direction */ 
int format; /* XYBitmap, XYPixmap, ZPixmap */ 
char *data; /* pointer to image data */ 
int byte order; /* data byte order, LSBFirst, MSBFirst */ 
int bitmap_unit; jxroquant...Of SGan Liners, acl6pe szemy, 
int bitmap bit. order; /* LSBFixrst, MSBFirst:-*/ 
int bitmap_pad; /* 8, 16, 32 either XY or ZPixmap */ 
int depth; /* depth of image */ 
ime bycesyper line; /* accelerator to next line */ - 
int bits per pixel /* bits per pixel (ZPixmap) */ 
char *obdata; /* hook for the object routines to hang on */ 
Struct funcs” { /* image manipulation routines */ 
struct XImage *(*create image) (); 
int (*destroy image) (); 
unsigned “longm(*getspuxel) (iF 
‘int (*put_pixel) (); 
struct XImage *(*sub_image) (); 
intin(*addy prxe1)"(() ; 
} £; 
} XImage; 
Errors 
BadDrawable 
BadGC 
BadMatch See Description above. 
BadValue 


Related Commands 


ImageByteOrder, XAddPixel, XCreateImage, XDest royImage, XGet Image, 
XGetPixel, XGetSubImage, XPutPixel, XSubImage. 
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Name 
XPutPixel — set a pixel value in an image. 


Synopsis 
int XPutPixel (ximage, x, y, pixel) 
XImage *ximage; 
TNMs 
Ve Ys 
unsigned long pixel; 


Arguments 
ximage Specifies a pointer to the image to be modified. 
x Specify the x and y coordinates of the pixel to be set, relative to the origin of 
y the image. 
pixel Specifies the new pixel value. 
Description 


XPutPixel overwrites the pixel in the named image with the specified pixel value. The x 
and y coordinates are relative to the origin of the image. The input pixel value must be in same 
bit- and byte-order as the machine in which the client is running (that is, the Least Significant 
Byte (LSB) of the long is the LSB of the pixel). The x and y coordinates must be contained in 


the image. 
Structures 

typedef struct XImage { 
int width, height; /* size of image */ 
int xoffset; /* number of pixels offset in x direction */ 
int format; /* XYBitmap, XYPixmap, ZPixmap */ 
char *data; /* pointer to image data */ 
int byte order; /* data byte order, LSBFirst, MSBFirst */ 
int bitmap_unit; /* quant. of scan line 8, 16,662rm)/ 
int bitmap _bit order; /* LSBFirst, MSBFirst */ 
int bitmap pad; /* 8, 16, 32 either XY or ZPixmap */ 
int depth; /* depth of image */ 
int bytes per line; /* accelerator to next line */ 
sie Joliet, fol=q_ jos. <eule /* bits per pixel (ZPixmap) */ 
unsigned long red_mask; /* bits in z arrangment */ 


unsigned long green_mask; 
unsigned long blue_mask; 
char *obdata; /* hook for the object routines to hang on */ 
struct) funcs 4 /* image manipulation routines */ 
struct XImage *(*create image) (); 
int (*destroy image) (); 
unsigned long (*get_pixel) (); 
inte(*put spixel).(); 
struct XImage *(*sub image) (); 
ints (*adde pixel)" ()'; 
ye 289 
} XImage; 
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Related Commands ; 
ImageByteOrder, XAddPixel, XCreateImage, XDest royImage, XGet Image, 
XGetPixel, XGetSubImage, XPut Image, XSubImage. 
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Name 
XQueryBestCursor — get the closest supported cursor sizes. 


Synopsis 
Status XQueryBestCursor (display, drawable, width, height, 
rwidth, rheight) 
Display *display; 
Drawable drawable; 
unsigned int width, height; 
unsigned int *rwidth, *rheight; /* RETURN */ 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
drawable Specifies a drawable that indicates which screen the cursor is to be used on. 

The best cursor may be different on different screens. 

width Specify the preferred width and height, in pixels. 
height 
rwidth Returns the closest supported cursor dimensions, in pixels, on the display 
rheight hardware. 

Description 


XQueryBestCursor returns the closest cursor dimensions actually supported by the display 
hardware to the dimensions you specify. 


Call this function if you wish to use a cursor size other than 16 by 16. XQueryBestCursor 
provides a way to find out what size cursors are actually possible on the display. Applications 
should be prepared to use smaller cursors on displays which cannot support large ones. 


XQueryBestCursor returns nonzero if the call succeeded in getting a supported size (which 
may be the same or different from the specified size), or zero if the call failed. 


Errors 
BadDrawable 


Related Commands 
XCreateFontCursor, XCreateGlyphCursor, XCreatePixmapCursor, XDefine- 
Cursor, XFreeCursor, XQueryBestSize, XRecolorCursor, XUndefineCursor. 
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Name 
XQueryBestSize — obtain the “best” supported cursor, tile, or stipple size. 


Synopsis 
Status XQueryBestSize (display, class, drawable, width, 
height, rwidth, rheight) 
Display *display; 
int class; 
Drawable drawable; Ee 
unsigned int width, height; 
unsigned int *rwidth, *rheight; /* RETURN */ 


Arguments 

display Specifies a connection to an X server; returned from XOpenDisplay. 

class Specifies the class that you are interested in. Pass one of these constants: 
TileShape, CursorShape, or StippleShape. 

drawable Specifies a drawable ID that tells the server which screen you want the best 
size for. 

width Specify the preferred width and height in pixels. 

height 

rwidth Return the closest supported width and height, in pixels, available for the 

rheight object on the display hardware. 


Description 
XQueryBestSize returns the “fastest” or “closest” size to the specified size. For class of 
CursorShape, this is the closest size that can be fully displayed on the screen. For Tile- 
Shape and St ippleShape, this is the closest size that can be tiled or stippled “fastest.” 


For CursorShape, the drawable indicates the desired screen. For TileShape and 
StippleShape, the drawable indicates the screen and possibly the visual class and depth 
(server-dependent). An InputOn1ly window cannot be used as the drawable for Ti leShape 
or StippleShape (else a BadMat ch error occurs). 


XQueryBestSize returns nonzero if the call succeeded in getting a supported size (may be 
the same or different from the specified size), or zero if the call failed. 

Errors 
BadDrawable 
BadMatch InputOn1y drawable for class TileShape or StippleShape. 
BadValue 


Xlib Reference Manual - 343 


XQueryBestSize (continued) Xlib — Pixmaps and Tiles 


Related Commands 
XCreateBitmapFromData, XCreatePixmap, XCreatePixmapFromBitmapData, 
XF reePixmap, XQueryBestStipple, XQueryBestTile, XReadBitmapFile, 
XSetTile, XSetWindowBackgroundPixmap, XSetWindowBorderPixmap, 
XWriteBitmapFile. 
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Name ° 
XQueryBestStipple — obtain the fastest supported stipple shape. 


Synopsis 
Status XQueryBestStipple (display, drawable, width, height, 
rwidth, rheight) 
Display *display; 
Drawable drawable; 
unsigned int width, height; 
unsigned int *rwidth, *rheight; /* RETURN */ 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
drawable Specifies a drawable that tells the server which screen you want the best size 

for. 

width . Specify the preferred width and height in pixels. 
height 
rwidth Return the width and height, in pixels, of the stipple best supported by the 
rheight display hardware. 

Description 


XQueryBestStipple returns the closest stipple size that can be stippled fastest. The draw- 
able indicates the screen and possibly the visual class and depth. An InputOnly window 
cannot be used as the drawable (else a BadMat ch error occurs). 


XQueryBestStipple returns nonzero if the call succeeded in getting a supported size (may 
be the same or different from the specified size), or zero if the call failed. 


For more information on stipples, see Volume One, Chapter 5, The Graphics Context. 

Errors 
BadDrawable 
BadMatch InputOn1ly window. 

Related Commands 
XCreateBitmapFromData, XCreatePixmap, XCreatePixmapFromBitmapData, 
XFreePixmap, XQueryBestSize, XQueryBestTile, XReadBitmapFile, XSet- 


Tile, XSetWindowBackgroundPixmap, XSetWindowBorderPixmap, XWrite- 
BitmapFile. 
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Name 
XQueryBestTile — obtain the fastest supported fill tile shape. 


Synopsis 
Status XQueryBestTile (display, drawable, width, height, 
rwidth, rheight) 
Display *display; 
Drawable drawable; 
unsigned int width, height; 
unsigned int *rwidth, *rheight; /* RETURN */ 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
drawable Specifies a drawable that tells the server which screen you want the best size 

for. 

width Specify the preferred width and height in pixels. 
height 
rwidth Return the width and height, in pixels, of the tile best supported by the dis- 
rheight play hardware. 

Description 


XQueryBestTile returns the closest size that can be tiled fastest. The drawable indicates 
the screen and possibly the visual class and depth. An InputOn1ly window cannot be used as 
the drawable. 


XQueryBestTile returns nonzero if the call succeeded in getting a supported size (may be 
the same or different from the specified size), or zero if the call failed. 


For more information on tiles, see Volume One, Chapter 5, The Graphics Context. 


Errors 
BadDrawable 


BadMatch InputOn1ly drawable specified. 


Related Commands 
XCreateBitmapFromData, XCreatePixmap, XCreatePixmapFromBitmapData, 
XF reePixmap, XQueryBestSize, XQueryBestStipple, XReadBitmapFile, 
XSet Tile, XSetWindowBackgroundPixmap, XSetWindowBorderPixmap, 
XWriteBitmapFile. 


346 Xlib Reference Manual 


— Xlib — Color Cells XQueryColor 


Name 
XQueryColor — obtain the RGB values and flags for a specified colorcell. 
Synopsis 
XQueryColor (display, cmap, colorcell_def) 
Display *display; 
Colormap cmap; 


XColor *colorcell_def; /* SEND and RETURN */ 
Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
cmap Specifies the ID of the colormap from which RGB values will be retrieved. 


colorcell def 
Specifies the pixel value and returns the RGB contents of that colorcell. 


Description 
XQueryColor returns the RGB values in colormap cmap for the colorcell corresponding to 
the pixel value specified in the pixel member of the XColor structure colorcell def. 
The RGB values are returned in the red, green, and blue members of that structure, and the 
flags member of that structure is set to (DoRed | DoGreen | DoBlue). The values 
returned for an unallocated entry are undefined. 


For more information, see Volume One, Chapter 7, Color. 


Structures 
typedef struct { 
unsigned long pixel; 
unsigned short red, green, blue; 


char flags; /* DoRed, DoGreen, DoBlue */ 
char pad; 
} XColor; 
Errors 
BadColormap 
BadValue Pixel not valid index into cmap. 


Related Commands 
BlackPixel, WhitePixel, XAllocColor, XAllocColorCells, XAllocColor- 
Planes, XAllocNamedColor, XFreeColors, XLookupColor, XParseColor, 
XQueryColors, XStoreColor, XStoreColors, XStoreNamedColor. 
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Name 
XQueryColors — obtain RGB values for an array of colorcells. 


Synopsis 
XQueryColors (display, cmap, colorcell_defs, ncolors) 
Display *display; 
Colormap cmap; 
XColor colorcell_defs[ncolors]; /* SEND and RETURN */ 
Lit ~RCOLOrs: 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
cmap Specifies the ID of the colormap from which RGB values will be retrieved. 


colorcel I defts j 
Specifies an array of XColor structures. In each one, pixel] is set to indi- 
cate which colorcell in the colormap to return, and the RGB values in that 
colorcell are returned in red, green, and blue. 


ncolors Specifies the number of XColor structures in the color definition array. 


Description 
XQueryColors is similar to XQueryColor, but it returns an array of RGB values. It 
returns the RGB values in colormap cmap for the colorcell corresponding to the pixel value 
specified in the pixel member of the XColor structure colorcell_def. The RGB values 
are returned in the red, green, and blue members of that same structure, and sets the 
flags member in each XColor structure to (DoRed | DoGreen | DoBlue). 


For more information, see Volume One, Chapter 7, Color. 


Structures 
typedef struct { 
unsigned long pixel; 
unsigned short red, green, blue; 
char flags; /* DoRed, DoGreen, DoBlue */ 
char pad; 
} “XColloxr? 


Errors 
BadColormap Specified colormap does not exist. 
BadValue Pixel not valid index into cmap. 
Note: if more than one pixel value is in error, the one reported is arbitrary. 
Related Commands 
BlackPixel, WhitePixel, XAllocColor, XAllocColorCells, XAllocColor- 


Planes, XAllocNamedColor, XFreeColors, XLookupColor, XParseColor, 
XQueryColor, XStoreColor, XStoreColors, xStoreNamedColor. 
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Name 
XQueryExtension — get extension information. 


Synopsis 
Bool XQueryExtension(display, name, major_opcode, 
first_event, first_error) 
Display *display; 
char *name; 


int *major_opcode; _/* RETURN */ 
ints *first: event; / * RETURN 9 */ 
int *firet error; /* RETURN */ 
Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
name Specifies the name of the desired extension. Upper or lower case is impor- 


tant. The string should be in ISO LATIN-1 encoding, which means that the 
first 128 character codes are ASCII, and the second 128 character codes are 
for special characters needed in western languages other than English. 


major_opcode 
Returns the major opcode of the extension, for use in error handling routines. 


first_event Returns the code of the first custom event type created by the extension. 
first_error Returns the code of the first custom error defined by the extension. 


Description 
XQueryExtension determines if the named extension is present, and returns True if it is. 
If so, the routines in the extension can be used just as if they were core Xlib requests, except 
that they may return new types of events or new error codes. The available extensions can be 
listed with XListExtensions. 


The major_opcode for the extension is returned, if it has one. Otherwise, zero is returned. 
This opcode will appear in errors generated in the extension. 


If the extension involves additional event types, the base event type code is returned in 
first_event. Otherwise, zero is returned in first_event. The format of the events is 
specific to the extension. 


If the extension involves additional error codes, the base error code is returned in 
first_error. Otherwise, zero is returned. The format of additional data in the errors is 
specific to the extension. 


See Volume One, Chapter 13, Other Programming Techniques, for more information on using 
extensions, and Volume One, Appendix C, Writing Extensions to X, for information on writing 
them. 


Related Commands 
XFreeExtensionList, XListExtensions.- 
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Name 


XQueryFont — return information about a loaded font. 


Synopsis 


XFontStruct *XQueryFont (display, font_ID) 


Display *display; 
SLD. font. FD; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
fone: ID Specifies either the font ID or the graphics context ID. You can declare the 
data type for this argument as either Font or GContext (both X IDs). If 
GContext, the font in that GC will be queried. 
Description . 


XQueryFont returns a pointer to an XFontStruct structure containing information 
describing the specified font. This call is needed if you loaded the font with XLoadFont, but 
need the font information for multiple calls to determine the extent of text. XLoadQuery- 
Font combines these two operations. 


If the font hasn’t been loaded (or the font ID passed is invalid), XQueryFont returns NULL. 


If font_ID is declared as data type GContext (also a resource ID), this function queries the 
font specified by the font component of the GC specified by this ID. This is useful for getting 
information about the default font, whose ID is stored in the default GC. However, in this case 
the GContext ID will be the ID stored in the £id field of the returned XFont Struct, and 
you can’t use that ID in XSet Font or XUnloadFont, since it is not itself the ID of the font. 


Use XFreeFont to free this data. 


For more information on fonts, see Volume One, Chapter 6, Drawing Graphics and Text. 


Errors 
BadFont 
Structures 
typedef struct { 
XExtData *ext data; /* hook for extension to hang data */ 
Bone tucia (x. fOnt ED sforsithis font. */ 
unsigned direction; /* hint about direction font is painted */ 
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unsigned min char or byte2; /* first character */ 
unsigned max_char_or byte2; /* last character */ 


unsigned min_bytel; /* first row that exists */ 

unsigned max_bytel; /* last row that exists */ 

Bool all chars exist; /* flag if all characters have nonzero sizex*/ 
unsigned default char; /* char to print for undefined character */ 
int n_properties; /* how many properties there are */ 

XFontProp *properties; /* pointer to array of additional properties*/ 
XCharStruct min_bounds; /* minimum bounds over all existing char*/ 
XCharStruct max bounds; /* minimum bounds over all existing char*/ 
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XCharStruct *per char; -/* first char to last char information */ 

ie ae ae ; 
int ascent; /* logical extent above baseline for spacing */ 
int descent; /* logical descent below baseline for spacing */ 


} XFontStruct's 


Related Commands 
XCreateFontCursor, XFreeFont, XFreeFontiInfo, XFreeFontNames, XFree- 
FontPath, XGetFontPath, XGetFontProperty, XListFonts, XListFontswWith- 
Info, XLoadFont, XLoadQueryFont, XSetFont, XSetFontPath, XUnloadFont. 
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Name 
XQueryKeymap — obtain a bit vector for the current state of the keyboard. 


Synopsis 
XQueryKeymap (display, keys) 
Display *display; 


char keys[32]; /* RETURN */ 
Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
keys Returns an array of bytes that identifies which keys are pressed down. Each 


bit represents one key of the keyboard. 


Description 
XQueryKeymap returns a bit vector for the logical state of the keyboard, where each bit set to 
1 indicates that the corresponding key is currently pressed down. The vector is represented as 
32 bytes. Byte N (from 0) contains the bits for keys 8N to 8N+7 with the least significant bit in 
the byte representing key 8N. Note that the logical state may lag the physical state if device 
event processing is frozen due to a grab. 


Related Commands 
XChangeKeyboardMapping, XDeleteModifiermapEntry, XFreeModifiermap, 
XGetKeyboardMapping, XGetModifierMapping, XInsertModifiermapEntry, 
XKeycodeToKeysym, XKeysymToKeycode, XKeysymToSt ring, XLookupKeysym, 
XLookupSt ring, XNewModifierMap, XRebindKeysym, XRefreshKeyboard- 
Mapping, XSetModifierMapping, XStringToKeysym. 
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Name 
XQueryPointer — get the current pointer location. 


Synopsis 
Bool XQueryPointer (display, w, root, child, root_x, root_y, 
win x, win_y, keys_buttons) 
Display *display; 
Window w; 


Window *root, *child; /* RETURN */ 
int. *roo0t_x; *root y; wh X RETURN 
int *win x, *win_y; /* RETURN */ 


unsigned int *keys_ buttons; /* RETURN */ 


Arguments 

display Specifies a connection to an X server; returned from XOpenDisplay. 

w Specifies a window which indicates which screen the pointer position is 
returned for, and child will be a child of this window if pointer is inside a 
child. 

root Returns the root window ID the pointer is currently on. 

child Returns the ID of the child of w the pointer is located in, or zero if it not in a 
child. 

root_x Return the x and y coordinates of the pointer relative to the root’s origin. 

FOOLY 

win _x Return the x and y coordinates of the pointer relative to the origin of window w. 

win _y 


keys_buttons 
Returns the current state of the modifier keys and pointer buttons. This is a 
mask composed of the OR of any number of the following symbols: Shift- 
Mask, LockMask, ControlMask, ModlMask, Mod2Mask, Mod3Mask, 
Mod4Mask, Mod5Mask, Button1lMask, Button2Mask, Button3Mask, 
Button4Mask, Button5Mask. 


Description 
XQueryPointer gets the pointer coordinates relative to a window and relative to the root 
window, the root window ID and the child window ID (if any) the pointer is currently in, 
and the current state of modifier keys and buttons. 


If XQueryPointer returns False, then the pointer is not on the same screen as w, childis 
None, and win_x and win_y are zero. However, root, root_x, and root_y are still 
valid. If XQueryPointer returns True, then the pointer is on the same screen as the win- 
dow w, and all return values are valid. 


The logical state of the pointer buttons and modifier keys can lag behind their physical state if 
device event processing is frozen due to a grab. 
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Errors 
BadWindow 


Related Commands 
XChangeActivePointerGrab, XChangePointerControl, XGetPointer- 
Control, XGetPointerMapping, XGrabPointer, XSetPointerMapping, 
XUngrabPointer, XWarpPointer. 
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Name 


XQueryTextExtents — query the server for string and font metrics. 


Synopsis 


XQueryTextExtents (display, font_ID, string, nchars, 
direction, ascent, descent, overall) 
Display *display; 
XID font_ID; 
char: *string; 
int nchars; 


int *direction; /* RETURN */ 
int *ascent, *descent; /* RETURN */ 
XCharStruct *overall; /* RETURN */ 
Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
font_ID Specifies the appropriate font ID previously returned by XLoadFont, or the 
GContext that specifies the font. 
string Specifies the character string for which metrics are to be returned. 
nchars Specifies the number of characters in st ring. 
direction Returns the direction the string would be drawn using the specified font. 
Either FontLeftToRight or FontRightToLeft. 
ascent Returns the maximum ascent for the specified font. 
descent Returns the maximum descent for the specified font. 
overall Returns the overall characteristics of the string. These are the sum of the 
width measurements for each character, the maximum ascent and 
descent, the minimum lbearing added to the width of all characters up 
to the character with the smallest lbearing, and the maximum rbearing 
added to the width of all characters up to the character with the largest 
rbearing. 
Description 


XQueryTextExtents returns the dimensions in pixels that specify the bounding box of the 
specified string of characters in the named font, and the maximum ascent and descent for the 
entire font. This function queries the server and, therefore, suffers the round trip overhead that 
is avoided by XTextExtents, but XQueryTextExtents does not require a filled xFont- 
Info structure stored on the client side. Therefore, this would be used when memory is pre- 
cious, or when just a small number of text width calculations are to be done. 


The returned ascent and descent should usually be used to calculate the line spacing, 
while the width, rbearing, and lbearing members of overali should be used for hori- 
zontal measures. The total height of the bounding rectangle, good for any string in this font, is 
ascent + descent. 
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overall.ascent is the maximum of the ascent metrics of all characters in the string. The 
overall.descent is the maximum of the descent metrics. The overall.width is the 
sum of the character-width metrics of all characters in the string. The overall. lbearing 
is usually the Ibearing of the first character in the string, and overall. rbearing is the 
rbearing of the last character in the string plus the sum of the widths of all the characters up to 
but not including the last character. More technically, here is the X protocol definition: For 
each character in the string, let W be the sum of the character-width metrics of all characters 
preceding it in the string, let L be the lbearing metric of the character plus W, and let R be the 
rbearing metric of the character plus W. The overall.lbearing is the minimum L of all 
characters in the string, and the overall.rbearing is the maximum R. 


For more information on drawing text, see Volume One, Chapter 6, Drawing Graphics and 
Text. 


Structures 
typedef struct { < 
short lbearing; /* origin to left edge of character */ 
short rbearing; /* origin to right edge of character */ 
short width; /* advance to next char’s origin */ 
short ascent; /* baseline to top edge of character */ 
short descent; /* baseline to bottom edge of character */ 


unsigned short attributes; /* per char flags (not predefined) */ 
} XCharStruct; 


Errors 


BadFont 


Related Commands 
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XDrawImageString, XDrawImageString16, XDrawString, XDrawStringl6, 
XDrawText, XDrawText16, XQueryTextExtents16, XTextExtents, XText- 
Extents16, XTextWidth, XTextWidthl16. 
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Name 


XQueryTextExtents16 — query the server for string and font metrics of a 16-bit character 


Synopsis 


string. 


XQueryTextExtentsl6 (display, font_ID, string, nchars, 
direction, ascent, descent, overall) 
Display *display; 
XIDalfont_.ID; 
XChar2b *string; 
intwnecharzsi: 


int *direction,: /* RETURN */ 
ant *ascent, *descent; /* RETURN */ 
XCharStruct *overall; /* RETURN */ 
Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
font_ID Specifies the appropriate font ID previously returned by XLoadFont, or the 
GContext that specifies the font. 
string Specifies the character string for which metrics are to be returned. 
nchars Specifies the number of characters in st ring. 
direction Returns the direction of painting in the specified font. Either Font Leftto- 
Right or FontRighttoLeft. 
ascent Returns the maximum ascent in pixels for the specified font. 
descent Returns the maximum descent in pixels for the specified font. 
overall Returns the overall characteristics of the string. These are the sum of the 
width measurements for each character, the maximum ascent and 
descent, the minimum lbearing added to the width of all characters up 
to the character with the smallest lbearing, and the maximum rbearing 
added to the width of all characters up to the character with the largest 
rbearing. 
Description 


XQueryTextExtents16 returns the dimensions in pixels that specify the bounding box of 
the specified string of characters in the named font, and the maximum ascent and descent for 
the entire font. This function queries the server and, therefore, suffers the round trip overhead 
that is avoided by XTextExtents16, but XQueryTextExtents does not require a filled 
XFont Info structure. 


The returned ascent and descent should usually be used to calculate the line spacing, 
while the width, rbearing, and lbearing members of overall should be used for hori- 
zontal measures. The total height of the bounding rectangle, good for any string in this font, is 
ascent + descent. 
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overall.ascent is the maximum of the ascent metrics of all characters in the string. The 
overall.descent is the maximum of the descent metrics. The overall.width is the 
sum of the character-width metrics of all characters in the string. The overall. lbearing 
is usually the lbearing of the first character in the string, and overall. rbearing is the 
rbearing of the last character in the string plus the sum of the widths of all the characters up to 
but not including the last character. More technically, here is the X protocol definition: For 
each character in the string, let W be the sum of the character-width metrics of all characters 
preceding it in the string, let L be the lbearing metric of the character plus W, and let R be the 
rbearing metric of the character plus W. The overall.lbearing is the minimum L of all 
characters in the string, and the overall.rbearing is the maximum R. 


For fonts defined with linear indexing rather than two-byte matrix indexing, the server inter- 
prets each XChar2b as a 16-bit number that has been transmitted with the most significant 
byte first. That is, byte one of the XChar2b is taken as the most significant byte. 


If the font has no defined default character, then.undefined characters in the string are taken to 
have all zero metrics. 


Structures 


typedef struct { /* normal 16-bit characters are two bytes */ 
unsigned char bytel; 
unsigned char byte2; 

} XChar2b; 


Gypedek-sitmuct: { 


short lbearing; /* origin to left edge of character */ 
short rbearing; /* origin to right edge of character */ 
short width; /* advance to next char’s origin */ 

short ascent; /* baseline to top edge of character */ 
short descent; /* baseline to bottom edge of character */ 


unsigned short attributes; /* per char flags (not predefined) */ 
} XCharStruct; 


Errors 


BadFont 


Related Commands 
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xDrawImageString, XDrawImageString16, XDrawString, XDrawStringl6, 
XDrawText, XDrawText16, XQueryTextExtents, XTextExtents, XText- 
Extents16, XTextWidth, XTextWidthl16. 
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Name 
XQueryTree — return a list of children, parent, and root. 


Synopsis 


Status XQueryTree (display, w, root, parent, children, 
nchildren) 
Display *display; 
Window w; 
Window *root; /* RETURN */ 
Window *parent; /* RETURN */ 
Window **children; /* RETURN */ 
unsigned int *nchildren; /* RETURN */ 
Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
Ww Specifies the ID of the window to be queried. For this window, XQuery- 
Tree will list its children, its root, its parent, and the number of children. 
root . Returns the root ID for the specified window. 
parent Returns the parent window of the specified window. 
children Returns the list of children associated with the specified window. 


nchildren Returns the number of children associated with the specified window. 


Description 


XQueryTree uses its last four arguments to return the root ID, the parent ID, a pointer to a list 
of children and the number of children in that list, all for the specified window w. The chil- 
dren are listed in current stacking order, from bottommost (first) to topmost (last). XQuery- 


Tree returns zero if it fails, nonzero if it succeeds. 


You should deallocate the list of children with XF ree when it is no longer needed. 


Errors 
BadWindow 


Related Commands 


XCirculateSubwindows, XCirculateSubwindowsDown, XCirculate- 
SubwindowsUp, XConfigureWindow, XLowerWindow, XMoveResizeWindow, 
XMoveWindow, XRaiseWindow, XReparentWindow, XResizeWindow, XRestack- 


Windows. 
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Name 
XRaise Window — raise a window to the top of the stacking order. 


Synopsis 
XRaiseWindow (display, w) 
Display *display; 
Window w; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
w Specifies the ID of the window to be raised to the top of the stack. 
Description 


XRaiseWindow moves a window to the top of the stacking order among its siblings. If the 
windows are regarded as overlapping sheets of paper stacked on a desk, then raising a window 
is analogous to moving the sheet to the top of the stack, while leaving its x and y location on 
the desk constant. 


Raising a mapped window may generate exposure events for that window and any mapped 
subwindows of that window that were formerly obscured. 


If the override redirect attribute of the window (see Volume One, Chapter 4, Window 
Attributes) is False and the window manager has selected Subst ructureRedirectMask 
on the parent, then a ConfigureRequest event is sent to the window manager, and no fur- 
ther processing is performed. 


Errors 
BadWindow 


Related Commands 
XCirculateSubwindows, XCirculateSubwindowsDown, XCirculate- 
SubwindowsUp, XConfigureWindow, XLowerWindow, XMoveResizeWindow, 
XMoveWindow, XQueryTree, XReparentWindow, XResizeWindow, XRestack- 
Windows. 
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Name 


XReadBitmapFile — read a bitmap from disk. __. 


Synopsis 


int XReadBitmapFile(display, drawable, filename, width, 


height, bitmap, x_hot, y_hot) 


Display *display; 
Drawable drawable; 
char *filename; 


unsigned int *width, *height; /* RETURN */ 
Pixmap *bitmap; /* RETURN */ 
ant *anhot,«*y hot; /* RETURN */ 
Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
drawable Specifies the drawable. 
filename Specifies the filename to use. The format of the filename is operating system 
specific. 
width Return the dimensions in pixels of the bitmap that is read. 
height 
bitmap Returns the pixmap resource ID that is created. 
x_hot Return the hotspot coordinates in the file (or —1,—1 if none present). 
y_hot 
Description 


XReadBitmapF ile reads in a file containing a description of a pixmap of depth 1 (a bitmap) 
in X Version 11 bitmap format. 


XReadBitmapF ile creates a pixmap of the appropriate size and reads the bitmap data from 
the file into the pixmap. The caller should free the pixmap using XFreePixmap when fin- 


ished with it. 


If the file cannot be opened, XReadBitmapFile returns BitmapOpenFailed. If the file 
can be opened but does not contain valid bitmap data, XReadBitmapFile returns Bitmap- 
FileInvalid. If insufficient working storage is allocated, KReadBitmapFile returns 
BitmapNoMemory. If the file is readable and valid, XReadBitmapFile returns Bitmap- 


Success. 
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Here is an example X Version 11 bitmap file: 


#define name _width 16 

#define name height 16 

#define name _x hot 8 

#define name y hot 8 

static char name bits[] = { 
Oxf8, Oxlf, Oxe3, Oxc7, Oxcf, Oxf3, Ox9f, Oxf9, Oxbf, (Oxfd). 10x33.) Oxce, 
Ox7£, Oxfe; Ox7f, Oxfe, Ox7e, Ox7e, Ox7f, Oxfe, 0x37, Oxec, Oxbb, Oxdd, 
Ox9e, 0x39, Oxct, Oxf3, Oxe3, Oxe7, OxfS, Oxlt}; 


For more information, see Volume One, Chapter 6, Drawing Graphics and Text. 


Errors 
BadDrawable 


Related Commands 
XCreateBitmapFromData, XCreatePixmap, XCreatePixmapFromBitmapData, 
XFreePixmap, XQueryBestSize, XQueryBestStipple, XQueryBestTile, XSet- 
Tile, XSetWindowBackgroundPixmap, XSetWindowBorderPixmap, XWrite- 
BitmapFile. 
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Name 
XRebindKeysym — rebind a keysym to a string for client. 


Synopsis 
XRebindKeysym(display, keysym, mod_list, mod_count, string, 

num_bytes) 

Display *display; 

KeySym keysym; 

KeySym *mod_list; 

int mod_count; 

unsigned char *string; 

int num_bytes; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
keysym Specifies the keysym to be rebound. 
mod_list Specifies a pointer to an array of keysyms that are being used as modifiers. 


mod_count _ Specifies the number of modifiers in the modifier list. 


string Specifies a pointer to the string that is to be copied and returned by 
XLookupSt ring in response to later events. 


num_bytes Specifies the length of the string. 


Description 
XRebindKeysym binds the ASCII string to the specified keysym, so that string and 
keysymare returned by XLookukpSt ring when that key is pressed and the modifiers speci- 
fied in mod_list are also being held down. This function rebinds the meaning of a keysym 
for a client. It does not redefine the keycode in the server but merely provides an easy way for 
long strings to be attached to keys. Note that you are allowed to rebind a keysym that may not 
exist. 


See Volume One, Chapter 9, The Keyboard and Pointer, for a description of keysyms and key- 
board mapping. 


Related Commands 
XChangeKeyboardMapping, XDeleteModifiermapEntry, XFreeModifiermap, 
XGetKeyboardMapping, XGetModifierMapping, XInsertModifiermapEntry, 
XKeycodeToKeysym, XKeysymToKeycode, XKeysymToString, XLookupKeysym, 
XLookupString, XNewModifierMap, XQueryKeymap, XRefreshKeyboard- 
Mapping, XSetModifierMapping, XStringToKeysym. 
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Name 
XRecolorCursor — change the color of a cursor. 


Synopsis 
XRecolorCursor (display, cursor, foreground_color, 
background_color) 
Display *display; 
Cursor Cursor; 
XColor *foreground_color, *background_color; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
Cursor Specifies the cursor ID. 


foreground_color 
Specifies the red, green, and blue (RGB) values for the foreground. 


background_color 
Specifies the red, green, and blue (RGB) values for the background. 


Description 
XRecolorCursor applies a foreground and background color to a cursor. Cursors are nor- 
mally created using a single plane pixmap, composed of 0’s and 1’s, with one pixel value 
assigned to 1’s and another assigned to 0’s. XRecolorCursor changes these pixel values. If 
the cursor is being displayed on a screen, the change is visible immediately. On some servers, 
these color selections are read/write cells from the colormap, and can’t be shared by applica- 
tions. 


Structures 
typedef struct { 
unsigned long pixel; 
unsigned short red, green, blue; 
chat milacs;; /* DoRed, DoGreen, DoBlue */ 
char pad; 
} XColor; 


Errors 
BadCursor 


Related Commands 
XCreateFontCursor, XCreateGlyphCursor, XCreatePixmapCursor, XDefine- 
Cursor, XFreeCursor, XQueryBestCursor, XQueryBest Size, XUndefine- 
CUESOE: 
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Name 
XReconfigureWMWindow — request that a top-level window be reconfigured. 


Synopsis 
Status XReconfigureWMWindow (display, w, screen_number, 

value_mask, values) 

Display *display; 

Window w; 

int screen_number; 

unsigned int value_mask; 

XWindowChanges *values; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
w Specifies the window. 


screen number 
; Specifies the appropriate screen number on the host server. 


value_mask Specifies which values are to be set using information in the values structure. 
This mask is the bitwise inclusive OR of the valid configure window values 
bits. 


values Specifies a pointer to the XWindowChanges structure. 


Availability 
Release 4 and later. 


Description 
XReconfigureWMWindow issues a ConfigureWindow request on the specified top-level 
window. If the stacking mode is changed and the request fails with a BadMatch error, the 
error event is trapped and a synthetic ConfigureRequest event containing the same confi- 
guration parameters is sent to the root of the specified window. Window managers may elect to 
receive this event and treat it as a request to reconfigure the indicated window. 


For more information, see Volume One, Chapter 10, Interclient Communication. 


Structures 
typedef struct { 
STi pe an 


int width, height; 
int border width; 
Window sibling; 
int stack_mode; 

} XWindowChanges; 
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Errors 
BadValue 
BadWindow 


Related Commands 
XIconifyWindow, XWithdrawWindow. 
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Name 
XRectInRegion — determine if a rectangle resides in a region. 


Synopsis 
int XRectInRegion(r, x, y, width, height) 
Region r; 
inte xe yy 
unsigned int width, height; 


Arguments 
Z Specifies the region. 
x Specify the x and y coordinates of the upper-left corner of the rectangle, rela- 
y tive to the region’s origin. 
width Specify the width and height in pixels of the rectangle. 
height 
Description 


XRectInRegion returns RectangleIn if the rectangle is completely contained in the 
region r, RectangleOut if it is completely outside, and RectanglePart if it is partially 
inside. 

Regions are located using an offset from a point (the region origin) which is common to all 
regions. It is up to the application to interpret the location of the region relative to a drawable. 
If the region is to be used as aclip_ mask by calling XSetRegion, the upper-left corner of 
region relative to the drawable used in the graphics request will be at (xoffset + 
clip x origin, yoffset + clip y origin), where xoffset and yoffset are 
the offset of the region and clip_x_originandclip y origin are the clip origin in the 
GC used. 


For this function, the x and y arguments are interpreted relative to the region origin; no draw- 
able is involved. 


Structures 
Region is a pointer to an opaque structure type. 


Related Commands 
XClipBox, XCreateRegion, XDestroyRegion, XEmptyRegion, XEqualRegion, 
XIntersectRegion, XOffsetRegion, XPoint InRegion, XPolygonRegion, 
XSetRegion, XShrinkRegion, XSubt ractRegion, XUnionRectWithRegion, 
XUnionRegion, XXorRegion. 
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Name 
XRefreshKeyboardMapping — read keycode-keysym mapping from server into Xlib. 
Synopsis 
XRefreshKeyboardMapping (event) 
XMappingEvent *event; 


Arguments 
event Specifies the mapping event that triggered this call. 


Description 
XRefreshKeyboardMapping causes Xlib to update its knowledge of the mapping between 
keycodes and keysyms. This updates the application’s knowledge of the keyboard. 


The application should call XRef reshKeyboardMapping when a MappingNotify event 
occurs. MappingNotify events occur when some client has called XChangeKeyboard- 
Mapping. . 

For more information, see Volume One, Chapter 9, The Keyboard and Pointer. 


Structures 
typedef struct { 

int type; 

unsigned long serial; /* # of last request processed by server */ 

Bool send event; /* true if this came from a SendEvent request */ 

Display *display; /* display the event was read from */ 

“Window window; /* unused */ 

int request; /* one of MappingModifier, MappingKeyboard, 
MappingPointer */ 

int first keycode; /* first keycode */ 

int count; /* defines range of change with first keycode*/ 


} XMappingEvent; 


Related Commands 
XChangeKeyboardMapping, XDeleteModifiermapEntry, XFreeModifiermap, 
XGetKeyboardMapping, XGetModifierMapping, XInsertModifiermapEntry, 
XKeycodeToKeysym, XKeysymToKeycode, XKeysymToString, XLookupKeysym, 
XLookupSt ring, XNewModifierMap, XQueryKeymap, XRebindKeysym, XSet- 
ModifierMapping, XStringToKeysym. 
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Name ; 
XRemoveFromSaveSet — remove a window from the client’s save-set. 


Synopsis 
XRemoveFromSaveSet (display, w) 
Display *display; 
Window w; 


Arguments ss 

display Specifies a connection to an X server; returned from XOpenDisplay. 

w Specifies the window you want to remove from this client’s save-set. This 
window must have been created by a client other than the client making this 
call. 

Description 


XRemoveF romSaveSet removes a window from the save-set of the calling application. 


The save-set is a safety net for windows that have been reparented by the window manager, 
usually to provide a shadow or other background for each window. When the window manager 
dies unexpectedly, the windows in the save-set are reparented to their closest living ancestor, so 
that they remain alive. 


This call is not necessary when a window is destroyed since destroyed windows are automati- 
cally removed from the save-set. Therefore, many window managers get away without ever 
calling XRemoveFromSaveSet. See Volume One, Chapter 14, Window Management, for 
more information about save-sets. 


Errors 
BadMatch w not created by some other client. 


BadWindow 


Reiated Commands 
XAddToSaveSet, XChangeSaveSet. 
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Name 
XRemoveHost — remove a host from the access control list. 


Synopsis 
XRemoveHost (display, host) 
Display *display; 
XHostAddress *host; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
host Specifies the network address of the machine to be removed. 
Description 


XRemoveHost removes the specified host from the access control list of the connected server. 
The server must be on the same host as the process that calls XRemoveHost in order to 
change the access control list. 


If you remove your own machine from the access control list, you can no longer connect to that 
server, and there is no way back from this call other than to log out, edit the access control file, 
and reset the server. 


The address data must be a valid address for the type of network in which the server oper- 
ates, as specified in the family member. 


For TCP/IP, the address should be in network byte order. For the DECnet family, the server 
performs no automatic swapping on the address bytes. A Phase IV address is two bytes long. 
The first byte contains the least significant eight bits of the node number. The second byte con- 
tains the most significant two bits of the node number in the least significant two bits of the 
byte, and the area in the most significant six bits of the byte. 


For more information on access control lists, see Volume One, Chapter 13, Other Programming 
Techniques. 


Structures 
typedef struct { 
int family; /* for example Family Internet */ 
int length; /* length of address, in bytes */ 
char *address; /* pointer to where to find the bytes */ 
} XHostAddress; 


/* constants used for family member of XHostAddress */ 


#define FamilyInternet 0 

#define FamilyDECnet 1 

#define FamilyChaos 2 
Errors 

BadAccess 

BadValue 
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Related Commands : 
XAddHost, XAddHosts, XDisableAccessControl, XEnableAccessControl, 
XListHosts, XRemoveHosts, XSetAccessControl. 
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Name 
XRemoveHosts — remove multiple hosts from the access control list. 


Synopsis 
XRemoveHosts (display, hosts, num_hosts) 
Display *display; 
XHostAddress *hosts; 
int num_hosts; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
hosts Specifies the list of hosts that are to be removed. 


num_hosts __ Specifies the number of hosts that are to be removed. 


Description 
XRemoveHosts removes each specified host from the access control list of the connected 
server. The server must be on the same host as the process that call XRemoveHosts, in order 
to change the access control list. 


If you remove your machine from the access control list, you can no longer connect to that 
server, and there is no way back from this call except to log out, edit the access control file, and 
reset the server. 


The address data must be a valid address for the type of network in which the server oper- 
ates, as specified in the family member. 


For TCP/IP, the address should be in network byte order. For the DECnet family, the server 
performs no automatic swapping on the address bytes. A Phase IV address is two bytes long. 
The first byte contains the least significant eight bits of the node number. The second byte con- 
tains the most significant two bits of the node number in the least significant two bits of the 
byte, and the area in the most significant six bits of the byte. 


For more information on access control lists, see Volume One, Chapter 13, Other Programming 


Techniques. 
Structures 
typedef struct { 
int family; /* for example Family Internet */ 
int length; /* length of address, in bytes */ 
char *address; /* pointer to where to find the bytes */ 


} XHostAddress; 


/* constants used for family member of XHostAddress */ 


#define FamilyInternet 0 
#define FamilyDECnet 1 
#define FamilyChaos 2 
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Errors F 
BadAccess : 
BadValue 


Related Commands 
XAddHost, XAddHosts, XDisableAccessControl, XEnableAccessControl, 
XListHosts, XRemoveHost, XSetAccessControl. 
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Name 
XReparentWindow — insert a window between another window and its parent. 


Synopsis 
XReparentWindow (display, win, parent, xX, y) 
Display *display; 
Window win; 
Window parent; 
mek vor. 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
win Specifies the ID of the window to be reparented. 
parent Specifies the window ID of the new parent window. 
x Specify the coordinates of the window relative to the new parent. 
4 
Description 


XReparentWindow modifies the window hierarchy by placing window win as a child of 
window parent. This function is usually used by a window manager to put a decoration win- 
dow behind each application window. In the case of the window manager, the new parent win- 
dow must first be created as a child of the root window. 


If win is mapped, an XUnmapWindow request is performed on it automatically. win is then 
removed from its current position in the hierarchy, and is inserted as a child of the specified 
parent. win is placed on top in the stacking order with respect to siblings. 


A ReparentNotify event is then generated. The override redirect member of the 
structure returned by this event is set to either True or False. Window manager clients nor- 
mally should ignore this event if this member is set to True. 


Finally, if the window was originally mapped, an XMapWindow request is performed automati- 
cally. 


Descendants of win remain descendants of win; they are not reparented to the old parent of 
win. 


Normal exposure processing on formerly obscured windows is performed. The server might 
not generate exposure events for regions from the initial unmap that are immediately obscured 
by the final map. The request fails if the new parent is not on the same screen as the old parent, 
or if the new parent is the window itself or an inferior of the window. 
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Errors ; 
BadMatch parent not on same screen as old parent of win. 
win has a ParentRelative background and parent is not the same 
depth as win. 
parent is winor an inferior of win. 
BadWindow 


Related Commands 
XCirculateSubwindows, XCirculatéSubwindowsDown, XCirculate- 
SubwindowsUp, XConfigureWindow, XLowerWindow, XMoveResizeWindow, 
XMoveWindow, XQueryTree, XRaiseWindow, XResizeWindow, XRestack- 
Windows. 
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Name 
XResetScreenSaver — reset the screen saver. 
Synopsis 
XReset ScreenSaver (display) 
Display *display; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 


Description 
XResetScreenSaver redisplays the screen if the screen saver was activated. This may 
result in exposure events to all visible windows if the server cannot save the screen contents. If 
the screen is already active, nothing happens. 


For more information on the screen saver, see Volume One, Chapter 13, Other Programming 
Techniques. 


Related Commands 


XActivateScreenSaver, XForceScreenSaver, XGetScreenSaver, XSet- 
ScreenSaver. 
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Name 
XResizeWindow — change a window’s size. + 


Synopsis 
XResizeWindow (display, w, width, height) 
Display *display; 
Window w; 
unsigned int width, height; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
w Specifies the ID of the window to be resized. 
width Specify the new dimensions of the window in pixels. _ 
height 
Description 


XResizeWindow changes the inside dimensions of the window. The border is resized to 
match but its border width is not changed. XResizeWindow does not raise the window, or 
change its origin. Changing the size of a mapped window may lose its contents and generate an 
Expose event, depending on the bit_ gravity attribute (see Volume One, Chapter 4, Win- 
dow Attributes). If a mapped window is made smaller, exposure events will be generated on 
windows that it formerly obscured. 


If the override redirect attribute of the window is False and the window manager has 
selected Subst ructureRedirectMask on the parent, then a ConfigureRequest event 
is sent to the window manager, and no further processing is performed. 


If the client has selected St ructureNotifyMask on the window, then a Configure- 
Notify event is generated after the move takes place, and the event will contain the final size 
of the window. 


Errors 
BadValue 
BadWwindow 


Reiated Commands 
XCirculateSubwindows, XCirculateSubwindowsDown, XCirculate- 
SubwindowsUp, XConfigureWindow, XLowerWindow, XMoveResizeWindow, 
XMoveWindow, XQueryTree, XRaiseWindow, XReparentWindow, XRestack- 
Windows. 
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Name 
XRestackWindows — change the stacking order of siblings. 


Synopsis 
XRestackWindows (display, windows, nwindows) ; 
Display *display; 
Window windows []; 
int nwindows; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
windows Specifies an array containing the windows to be restacked. All the windows 
must have a common parent. 
nwindows Specifies the number of windows in the windows array. 
Description 


XRestackWindows restacks the windows in the order specified, from top to bottom. The 
stacking order of the first window in the windows array will be on top, and the other windows 
will be stacked underneath it in the order of the array. Note that you can exclude other siblings 
from the windows array so that the top window in the array will not move relative to these 
other siblings. 


For each window in the window array that is not a child of the specified window, a BadMatch 
error will be generated. If the override redirect attribute of the window is False and 
the window manager has selected SubstructureRedirectMask on the parent, then 
ConfigureRequest events are sent to the window manager for each window whose over- 
ride_redirect is not set, and no further processing is performed. Otherwise, the windows 
will be restacked in top to bottom order. 


Errors 
BadMatch 
BadWindow 


Related Commands 
XCirculateSubwindows, XCirculateSubwindowsDown, XCirculate- 
SubwindowsUp, XConfigureWindow, XLowerWindow, XMoveResizeWindow, 
XMoveWindow, XQueryTree, XRaiseWindow, XReparentWindow, XResize- 
Window. 
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Name 
XrmDestroyDatabase — destroy a resource database. 


Synopsis 
void XrmDestroyDatabase (database) 
XrmDatabase database; 


Arguments 
database Specifies the resource database. 


Availability 
Release 4 and later. 


Description 
XrmDest royDatabase destroys a resource database and frees its allocated memory. The 
destroyed resource database should not be referenced again. If database is NULL, Xrm- 
Dest royDatabase returms immediately. 


For more information, see Volume One, Chapter 11, Managing User Preferences. 


Related Commands 
XrmMergeDatabases. 
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Name 


XrmGetFileDatabase — retrieve a database from a file. 


Synopsis 


XrmDatabase XrmGetFileDatabase (filename) — 
char *filename; 


Arguments 


filename Specifies the resource database filename. 


Description 


XrmGetFileDatabase opens the specified file, creates a new resource database, and loads 
the database with the data read in from the file. The return value of the function is as a pointer 
to the created database. 


The specified file must contain lines in the format accepted by XrmPut LineResource. If 
XrmGetFileDatabase cannot open the specified file, it returns NULL. 


For more information, see Volume One, Chapter 11, Managing User Preferences. 


Structures 


XrmDatabase is a pointer to an opaque data type. 


Related Commands 
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XrmDest royDatabase, XrmGetResource, XrmGet StringDatabase, Xrm- 
Initialize, XrmMergeDatabases, XrmParseCommand, XrmPutFileDatabase, 
XrmPut LineResource, XrmPutResource, XrmPutStringResource, XrmQGet- 
Resource, XrmQGetSearchList, XrmQGetSearchResource, XrmQPutResource, 
XrmQPut StringResource, XrmQuarkToString, XrmSt ringToBindingQuark- 
List, XrmStringToQuarkList, XrmStringToQuark, XrmUniqueQuark. 
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Name 
XrmGetResource — get a resource from name and class as strings. 


Synopsis 
Bool XrmGetResource (database, str_name, str_class, 
Str type, value) 
XrmDatabase database; 
char’ *str name; 
Ciae “ott Clacs, 


char **str type; -/* RETURN */ 
XrmValue *value; /* RETURN */ 
Arguments 
database Specifies the database that is to be used. 
str_name Specifies the fully specified name of the value being retrieved. 
str_class Specifies the fully specified class of the value being retrieved. 
str_type Returns a pointer to the representation type of the destination. In this func- 
tion, the representation type is represented as a string, not as an Xrm- 
Representation. 
value Returns the value in the database. Do not modify or free this data. 
Description 


The resource manager manages databases of resource specifications consisting of lines contain- 
ing resource name/class strings followed by a colon and the value of the resource. XrmGet - 
Resource retrieves a resource from the specified database. It takes fully specified name and 
class strings, and returns the representation and value of the matching resource. The value 
returned points into database memory; you must not modify that data. If a resource was found, 
XrmGet Resource returns True. Otherwise, it returns False. 


Currently, the database only frees or overwrites entries when new data is stored with Xrm- 
MergeDatabases, or XrmPutResource and related routines. A client that avoids these 
functions should be safe using the address passed back at any time until it exits. 


XrmGetResource is very similar to XrmQGetResource, except that in XrmQGet- 
Resource, the equivalent arguments to str_name, str_class, and str_type are 
quarks instead of strings. 


To understand how data is stored and retrieved from the database, you must understand: 
1) The basic components that make up the storage key and retrieval keys. 


2) How keys are made up from components. 
3) | The two ways that components can be bound together. 


4) What sort of keys are used to store and retrieve data. 
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5) 
6) 


How the storage key and retrieval keys are compared to determine whether they match. 


If there are multiple matches, how the best match is chosen so only one value is returned. 


Each will be covered in turn. 


1) 


2) 


3) 


4) 


The storage key and retrieval keys are composed of a variable number of components, 
bound together. There are two types of components: names and classes. By convention, 
names begin with a lower case character and classes begin with an upper case character. 
Therefore, xmh, background, and toc are examples of names, while Xmh, Box, and 
Command are examples of classes. A name key (like str_name) consists purely of 
name components. A class key (like st r_class ) consists purely of class components. 
The retrieval keys are a pair of keys, one composed of purely name components, the 
other of purely class components. A storage key (like specifier in XrmPut- 
Resource) consists of a mixture of name and class components. 


A key is composed of multiple components bound together in sequence. This allows you 
to build logical keys for your application. For example, at the top level, the application 
might consist of a paned window (that is, a window divided into several sections) named 
toc. One pane of the paned window is a button box window named buttons filled 
with command buttons. One of these command buttons is used to retrieve (include) 
new mail and has the name include. This window has a fully qualified name 
xmh.toc.buttons.include and a fully qualified class mh. VPaned.Box.Com- 
mand. Its fully qualified name is the name of its parent, xmh .toc . buttons, followed 


- by its name include. Its class is the class of its parent, Xmh . VPaned . Box, followed 


by its particular class, Command. 
The components in a key can be bound together in two ways: by a tight binding (a dot 


**””) or by a loose binding (an asterisk ‘‘*’’). Thus xmhtoc.backqround has three 
name components tightly bound together, while Xmh*Command. foreground uses 
both a loose and a tight binding. Bindings can also precede the first component (but may 
not follow the last component). By convention, if no binding is specified before the first 
component, a tight binding is assumed. For example, xmh.background and 
.xmh.background both begin with tight bindings before the xmh, while 
*xmh . background begins with a loose binding. 


The difference between tight and loose bindings comes when comparing two keys. A 
tight binding means that the components on either side of the binding must be sequential. 
A loose binding is a sort of wildcard, meaning that there may be unspecified components 
between the two components that are loosely bound togehter. For example, 
xmh.toc.background would match xmh*background and *backgrouna but 
not xmh .background or background. 


A key used to store data into the database can use both loose and tight bindings. This 
allows you to specify a data value which can match to many different retrieval keys. In 
contrast, keys used to retrieve data from the database can use only tight bindings. You 
can only look up one item in the database at a time. Remember also that a storage key 
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can mix name and class components, while the retrieval keys are a pair of keys, one con- 
sisting purely of name (first character lower case) components and one consisting purely 
of class (capitalized) components. 


5) The resource manager must solve the problem of how to compare the pair of retrieval 
keys to a single storage key. (Actually, to many single storage keys, since the resource 
manager will compare the retrieval keys against every key in the database, but one at a 
time.) The solution of comparing a pair of keys to a single key is simple. The resource 
manager compares component by component, comparing a component from the storage 
key against both the corresponding component from the name retrieval key, and the cor- 
responding component from the class retrieval key. If the storage key component 
matches either retrieval key component, then that component is considered to match. For 
example, the storage key xmh.toc.Foreground matches the name key 
xmh.toc.foreground with the class key Xmh.Box.Foreground. This is why 
storage keys can mix name and class components, while retrieval keys cannot. 


6) Because the resource manager allows loose bindings (wildcards) and mixing names and 
classes in the storage key, it is possible for many storage keys to match a single 
name/class retrieval key pair. To solve this problem, the resource manager uses the fol- 
lowing precedence rules to determine which is the best match (and only the value from 
that match will be returned). The precedence rules are, in order of preference: 


1. The attribute of the name and class must match. For example, queries for 


xterm. scrollbar.background (name) 
XTerm.Scrollbar.Background (class) 


will not match the following database entry: 
xterm.scrollbar: on 
because background does not appear in the database entry. 


2. Database entries with name or class prefixed by a dot (.) are more specific than those 
prefixed by an asterisk (*). For example, the entry xterm.geomet ry is more specific 
than the entry xterm*geomet ry. 


3. | Names are more specific than classes. For example, the entry *scrollbar.- 
background is more specific than the entry *Scrollbar.Background. 


4, A name or class is more specific than omission. For example, the entry 
Scrollbar*Background is more specific than the entry *Background. 


5. Left components are more specific than right components. For example, to query for 
.xterm.scrollbar.background, the entry xterm*background is more spe- 
cific than the entry scrollbar*background. 
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Names and classes can be mixed. As an example of these rules, assume the following user pref- 
erence specification: 


xmh*background: red 
*command. font: 8x13 
*command.background: blue 
*Command.Foreground: green 


xmh.toc*Command.activeForeground: black 


A query for the name xmh.toc.messagefunctions.include.activeForeground 
and class Xmh.VPaned.Box.Command.Foreground would match xmh.toc*- 
Command.activeForeground and return black. However, it also matches *Com- 
mand.Foreground but with lower preference, so it would not return green. 


For more information, see Volume One, Chapter 11, Managing User Preferences, and Volume 
Four, X Toolkit Intrinsics Programming Manual, Chapter 9, Resource Management and Type 
Conversion. 


Structures 


XrmDatabase is a pointer to an opaque data type. 


typedef struct { 


. unsigned int size; 
caddr t addr; 
} XrmValue; 


Related Commands 
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XrmDest royDatabase, XrmGetFileDatabase, XrmGetStringDatabase, Xrm- 
Initialize, XrmMergeDatabases, XrmParseCommand, XrmPutFileDatabase, 
XrmPut LineResource, XrmPutResource, XrmPut StringResource, XrmQGet - 
Resource, XrmQGetSearchList, XrmQGetSearchResource, XrmQPutResource, 
XrmQPut StringResource, XrmQuarkToString, XrmStringToBindingQuark- 
List, XrmStringToQuarkList, XrmStringToQuark, XrmUniqueQuark. 
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Name 
XrmGetStringDatabase — create a database from a string. 


Synopsis 
XrmDatabase XrmGetStringDatabase (data) 
cham, “data 


Arguments 
data Specifies the database contents using a string. 


Description 
XrmGetSt ringDatabase creates a new database and stores in it the resources specified in 
data. The return value is subsequently used to refer to the created database. XrmGet- 
StringDatabase is similar to XcmGetFileDatabase, except that it reads the informa- 
tion out of a string instead of a file. Each line in the string is separated by a new line character 
in the format accepted by XrmPut LineResource. 


For more information, see Volume One, Chapter 11, Managing User Preferences. 


Structures 
XrmDatabase is a pointer to an opaque data type. 


Related Commands 
¥rmDest royDatabase, XrmGetFileDatabase, XrmGetResource, Xrm- 
Initialize, XrmMergeDatabases, XrmParseCommand, XrmPutFileDatabase, 
XrmPut LineResource, XrmPut Resource, XrmPut St ringResource, XrmQGet - 
Resource, XrmQGetSearchList, XrmQGet SearchResource, XrmQPutResource, 
XrmQPut StringResource, XrmQuarkToString, XrmSt ringToBindingQuark- 
List, XrmStringToQuarkList, XrmStringToQuark, XrmUniqueQuark. 
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Name 
XrmiInitialize — initialize the resource manager. 


Synopsis 


void XrmInitialize(); 


Description 
XrmInitialize initializes the resource manager, and should be called once before using 
any other resource manager functions. It just creates a representation type of “String” for val- 
ues defined as strings. This representation type is used by XrmPut StringResource and 
XrmQPut St ringResource, which require a value as a string. See XrmQPutResource 
for a description of representation types. 


For more information, see Volume One, Chapter 11, Managing User Preferences. 


Related Commands 
XrmDest royDatabase, XrmGetFileDatabase, XrmGetResource, XrmGet- 
StringDatabase, XrmMergeDatabases, XrmParseCommand, XrmPutFile- 
Database, XrmPut LineResource, XrmPutResource, XrmPut StringResource, 
XrmQGetResource, XrmQGetSearchList, XrmQGet SearchResource, XrmQPut— 
Resource, XrmQPutStringResource, XrmQuarkToString, XrmString- 
ToBindingQuarkList, XrmStringToQuarkList, XrmStringToQuark, Xrm- 
UniqueQuark. 


386 Xlib Reference Manual 


— Xlib — Resource Manager XrmMergeDatabases 


Name 
XrmMergeDatabases — merge the contents of one database into another. 
Synopsis 
void XrmMergeDatabases(source_db, target_db) 
XrmDatabase source _db, *target_db; 


Arguments 
source db _ Specifies the resource database to be merged into the existing database. 


target_db Specifies a pointer to the resource database into which the source_db data- 
base will be merged. 


Description 
XrmMergeDatabases merges source_db into target_db. This procedure is used to 
combine databases, for example, an application specific database of defaults and a database of 
user preferences. The merge is destructive; it destroys the original source_db database and 
modifies the original target_db. 


For more information, see Volume One, Chapter 11, Managing User Preferences. 


Structures 
XrmDatabase is a pointer to an opaque data type. 


Related Commands 
XrmDest royDatabase, XrmGetFileDatabase, XrmGetResource, XrmGet—- 
StringDatabase, XrmInitialize, XrmParseCommand, XrmPutFileDatabase, 
XrmPut LineResource, XrmPutResource, XrmPutStringResource, XrmQGet- 
Resource, XrmQGetSearchList, XrmQGet SearchResource, XrmQPutResource, 
XrmQOPutStringResource, XrmQuarkToString, XrmSt ringToBindingQuark- 
List, XrmStringToQuarkList, XrmStringToQuark, XrmUniqueQuark. 
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Name 


XrmParseCommand — load a resource database from command line arguments. 


Synopsis 
void XrmParseCommand(db, table, table_count, name, argc, 
argv) 
XrmDatabase *db; /* SEND and if NULL, RETURN */ 


XrmOptionDescList table; 
int table count; 
char *name; 


ant *arge, /* SEND and RETURN */ 
char **argv; /* SEND and RETURN */ 
Arguments 
database Specifies a pointer to the resource database. If database contains NULL, a 
new resource database is created and a pointer to it is returned in database. 
table Specifies table of command line arguments to be parsed. 


table count Specifies the number of entries in the table. 
name Specifies the application name. 


argc Before the call, specifies the number of arguments. After the call, returns the 
number of arguments not parsed. 


argv Before the call, specifies a pointer to the command line arguments. After the 
call, returns a pointer to a string containing the command line arguments that 
could not be parsed. 


Description 
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XrmParseCommand parses an (argc, argv) pair according to the specified option table, 
loads recognized options into the specified database, and modifies the (argc, argv) pair to 
remove all recognized options. 


The specified table is used to parse the command line. Recognized entries in the table are 
removed from argv, and entries are made in the specified resource database. The table entries 
contain information on the option string, the option name, which style of option and a value to 
provide if the option kind is XrmoptionNoArg. See the example table below. 


argc specifies the number of arguments in argv and is set to the remaining number of argu- 
ments that were not parsed. name should be the name of your application for use in building 
the database entry. name is prepended to the resourceName in the option table before stor- 
ing the specification. No separating (binding) character is inserted. The table must contain 
either a dot (“.”) or an asterisk (“*”) as the first character in each resourceName entry. The 
resourceName entry can contain multiple components. 


The following is a typical options table: 


static XrmOptionDescRec opTable[ ] 
{"-background", "*background", XrmoptionSepArg, (caddr_t) NULL}, 


ll 
= 
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{"=-bda", "xborderColor", XrmoptionSepArg, (caddr_t) NULL}, 
(=o: "xXbackground™,  * ; XrmoptionSepArg, (caddr_t) NULL}, 
{"-borderwidth", "*TopLevelShell.borderWidth", XrmoptionSepArg, (caddr_t) NULL}, 
{"-bordercolor", "*borderColor", XrmoptionSepArg, (caddr_t) NULL}, 
{"=bw™, "xTopLevelShell.borderWidth", XrmoptionSepArg, (caddr_t) NULL}, 
{"-display", Weadisplaye; XrmoptionSepArg, (caddr_t) NULL}, 
{"-<f9",; "x foreground", XrmoptionSepArg, (caddr_t) NULL}, 
{ee Ub sarroh ghee XrmoptionSepArg, (caddr_t) NULL}, 
{r= font efonic', XrmoptionSepArg, (caddr_t) NULL}, 
{"-foreground", "*foreground", XrmoptionSepArg, (caddr_t) NULL}, 
{"-geometry", ".TopLevelShell.geometry", XrmoptionSepArg, (caddr_t) NULL}, 
{"-iconic", ".TopLevelShell.iconie", XrmoptionNoArg, (caddr vt) “on'};, 
{"-name", " .name", XrmoptionSepArg, (caddr_t) NULL}, 
{"-reverse", "kreverseVideo", XrmoptionNoArg, (caddrat) ont}, 
{Mee "xreverseVideo", XrmoptionNoArg, (caddie nt) Boni 
{"=synchronous", ".synchronous", XrmoptionNoArg, (caddr tt)" “on™)}, 
Cr—title, ".TopLevelShell.title", XrmoptionSepArg, (caddr_t) NULL}, 
{"-xrm", NULL, XrmoptionResArg, (caddr_t) NULL}, 


Pe 


In this table, if the -background (or -bg) option is used to set background colors, the stored 
resource specifier will match all resources of attribute background. If the -borderwidth option 
is used, the stored resource specifier applies only to border width attributes of class Top- 
LevelShel1 (that is, outermost windows, including pop-up windows). If the -title option is 
used to set a window name, only the topmost application windows receive the resource. 


When parsing the command line, any unique unambiguous abbreviation for an option name in 
the table is considered a match for the option. Note that upper case and lower case matter. 


For more information, see Volume One, Chapter 11, Managing User Preferences. 


Structures 
XrmDatabase is a pointer to an opaque data type. 


typedef enum { 


XrmoptionNoArg, /* value is specified in OptionDescRec.value */ 
XrmoptionIlsArg, /* value is the option string itself */ 
XrmoptionStickyArg, /* value is chars immediately following option */ 
XrmoptionSepArg, /* value is next argument in argv */ 
XrmoptionResArg, /* resource and value in next argument in argv */ 
XrmoptionSkipArg, /* ignore this option and next argument in argv */ 
XrmoptionSkipLine, /* ignore this option and the rest of argv */ 
XrmoptionSkipNArgs /* new in R4: ignore this option, skip 


number specified in next argument */ 
} XrmOptionKind; 


typedef struct { 


char *optiony; /* option specification string in argv */ 

char *resourceName; /* binding & resource name (w/out application name) */ 
XrmOptionKind argKind; /* which style of uption it is */ 

caddr_t value; /* value to provide if XrmoptionNoArg */ 


} XrmOptionDescRec, *XrmOptionDescList; 
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Related Commands 
XrmDestroyDatabase, XrmGetFileDatabase, XrmGetResource, XrmGet—- 
StringDatabase, XrmInitialize, XrmMergeDatabases, XrmPutFile- 
Database, XrmPut LineResource, XrmPutResource, XrmPutStringResource, 
XrmQGetResource, XrmQGetSearchList, XrmQGetSearchResource, XrmQPut- 
Resource, XrmQPut StringResource, XrmQuarkToString, XrmString- 
ToBindingQuarkList, XrmStringToQuarkList, XrmStringToQuark, Xrm- 
UniqueQuark. 
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Name 
XrmPutFileDatabase — store a resource database in a file. 


Synopsis 
void XrmPutFileDatabase (database, stored_db) 
XrmDatabase database; 
char *stored_db; 


Arguments 
database Specifies the resource database that is to be saved. 


stored_db Specifies the filename for the stored database. 


Description 
XrmPutFileDatabase stores a copy of the application’s current database in the specified 
file. The file is an ASCII text file that contains lines in the format that is accepted by XrmPut - 
LineResource. 


For more information, see Volume One, Chapter 11, Managing User Preferences. 


Structures 
XrmDatabase is a pointer to an opaque data type. 


Related Commands 
XrmDest royDatabase, XrmGetFileDatabase, XrmGetResource, XrmGet-— 
StringDatabase, XrmInitialize, XrmMergeDatabases, XrmParseCommand, 
XrmPut LineResource, XrmPutResource, XrmPut StringResource, XrmQGet- 
Resource, XrmQGetSearchList, XrmQGetSearchResource, XrmQPutResource, 
XrmQPutStringResource, XrmQuarkToString, XrmSt ringToBindingQuark- 
List, XrmStringToQuarkList, XrmStringToQuark, XrmUniqueQuark. 


Xlib Reference Manual : 391 


XrmPutLineResource \ hi paeiee ssceeee 


Name 


XrmPutLineResource — add a resource specification to a resource database. 


Synopsis 


void XrmPutLineResource (database, line) 
XrmDatabase *database; /* SEND, and if NULL, RETURN */ 
char *line; 


Arguments 
database Specifies a pointer to the resource database. If database contains NULL, a 
new resource database is created and a pointer to it is returned in database. 
line Specifies the resource name (possibly with multiple components) and value 
pair as a single string, in the format resource: value. 
Description ! 


XrmPut LineResource adds a single resource entry to the specified database. 


XrmPutLineResource is similar to XrmPutStringResource, except that instead of 
having separate string arguments for the resource and its value, XrmPutLineResource 
takes a single string argument (line) which consists of the resource name, a colon, then the 
value. Since the value is a string, it is stored into the database with representation type 
String. 


Any whitespace before or after the name or colon in the 1ine argument is ignored. The value 
is terminated by a new-line or a NULL character. The value may contain embedded new-line 
characters represented by the “\” and “n” two character pair (not the single “\n” character), 
which are converted into a single linefeed character. In addition, the value may run over onto 
the next line, this is indicated by a “\’ character at the end of each line to be continued. 


Null-terminated strings without a new line are also permitted. XrmPutResource, Xrm- 
QPutResource, XrmPutStringResource, XrmQPutStringResource and Xrm- 
PutLineResource all store data into a database. See XrmQPutResource for the most 
complete description of this process. 


For more information, see Volume One, Chapter 11, Managing User Preferences. 


Structures 
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XrmDatabase is a pointer to an opaque data type. 
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Related Commands 
XrmDest royDatabase, XrmGetFileDatabase, XrmGetResource, XrmGet - 
StringDatabase, XrmInitialize, XrmMergeDatabases, XrmParseCommand, 
XrmPutFileDatabase, XrmPutResource, XrmPutStringResource, XrmQGet - 
Resource, XrmQGetSearchList, XrmQGetSearchResource, XrmQPutResource, 
XrmQPut St ringResource, XrmQuarkToString, XrmSt ringToBindingQuark- 
List, XrmStringToQuarkList, XrmStringToQuark, XrmUniqueQuark. 
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Name 
XrmPutResource — store a resource specification into a resource database. 


Synopsis 
void XrmPutResource (database, specifier, type, value) 
XrmDatabase *database; /* SEND, and if NULL, RETURN */ 
char *specifier; 
char *type; 
XrmValue *value; 


Arguments 
database Specifies a pointer to the resource database. If database contains NULL, a new 
resource database is created and a pointer to it is returned in database. 


specifier Specifies a complete or partial specification of the resource. 


type Specifies the type of the resource. 
value Specifies the value of the resource. 
Description 


XrmPutResource is one of several functions which store data into a database. 


XrmQPutResource first converts specifier into a binding list and a quark list by calling 
XrmStringToBindingQuarkList, and converts type into an XrmRepresentation 
by calling XrmSt ringToRepresentation. Finally, it puts the data into the database. 


XrmPutResource, XrmQPutResource, XrmPutStringResource, XrmQPut- 
StringResource and XrmPutLineResource all store data into a database. See the 
description of XcmQPut Resource for the most complete description of this process. 


For more information, see Volume One, Chapter 11, Managing User Preferences. 


Structures 
XrmDatabase is a pointer to an opaque data type. 


typedef struct { 
unsigned int size; 
caddie addr; 

} XrmValue, *XrmValuePtr; 


Related Commands 
XrmDest royDatabase, XrmGetFileDatabase, XrmGetResource, XrmGet- 
StringDatabase, XrmInitialize, XrmMergeDatabases, XrmParseCommand, 
XrmPutFileDatabase, XrmPutLineResource, XrmPut StringResource, Xrm- 
QGet Resource, XrmQGet SearchList, XrmQGet SearchResource, XrmQPut- 
Resource, XrmQPut StringResource, XrmQuarkToString, XrmString- 
ToBindingQuarkList, XrmStringToQuarkList, XrmSt ringToQuark, Xrm- 
UniqueQuark. 
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Name ; 
XrmPutStringResource — add a resource specification with separate resource name and value. 


Synopsis 
void XrmPutStringResource (database, resource, value) 
XrmDatabase *database; /* SEND, and if NULL, RETURN */ 
char *resource; 
char *value; 


Arguments 
database Specifies a pointer to the resource database. If database contains NULL, a 
new resource database is created and a pointer to it is returned in database. 
resource Specifies the resource, as a string. 
value Specifies the value of the resource, as a string. 


Description 
XrmPutStringResource adds a resource specification with the specified resource and 
value to the specified database. The resource string may contain both names and classes, 
bound with either loose (*) or tight (.) bindings. See the description of xrmGet Resource for 
more information about bindings. 


The representation type used in the database is St ring. 


XrmPutResource, XrmQPutResource, XrmPutStringResource, XrmQPut- 
StringResource and XrmPutLineResource all store data into a database. See Xrm- 
QPutResource for the most complete description of this process. 


For more information, see Volume One, Chapter 11, Managing User Preferences. 


Structures 
XrmDatabase is a pointer to an opaque data type. 


Related Commands 
XrmDestroyDatabase, XrmGetFileDatabase, XrmGetResource, XrmGet- 
StringDatabase, XrmInitialize, XrmMergeDatabases, XrmParseCommand, 
XrmPutFileDatabase, XrmPutLineResource, XrmPutResource, XrmQGet—- 
Resource, XrmQGet SearchList, XrmQGet SearchResource, XrmQPutResource, 
XrmQPut StringResource, XrmQuarkToString, XrmSt ringToBindingQuark- 
List, XrmStringToQuarkList, XrmStringToQuark, XrmUniqueQuark. 
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Name 


XrmQGetResource — get a resource value using name and class as quarks. 


Synopsis 


Bool XrmQGetResource (database, quark_name, quark_class, 
quark _type, value) 
XrmDatabase database; 
XrmNameList quark_name; 
XrmClassList quark_class; 
XrmRepresentation *quark_type; /* RETURN */ 


XrmValue *value; /* RETURN */ 
Arguments 
database Specifies the database that is to be used. 


quark name Specifies the fully qualified name of the value being retrieved (as a list of 
quarks). 


quark class Specifies the fully qualified class of the value being retrieved (as a list of 
quarks). 

quark type Returns a pointer to the representation type of the value. In this function, the 
representation type is represented as a quark. 


value Returns a pointer to the value in the database. Do not modify or free this 
data. 


Description 


396 


XrmQGetResource retrieves a resource from the specified database. It takes fully qualified 
name and class strings, and returns the representation and value of the matching resource. The 
value returned points into database memory; you must not modify that data. If a resource was 
found, XrcmQGet Resource retums True. Otherwise, it returns False. 


Currently, the database only frees or overwrites entries when new data is stored with Xrm- 
MergeDatabases, or XrmPutResource and related routines. A client that avoids these 
functions should be safe using the address passed back at any time until it exits. 


XrmQGetResource is very similar to XrmGetResource, except that in XrmGet- 
Resource, the equivalent arguments to quark_name, quark_class, and quark_type 
arguments are strings instead of quarks. 


See XrmGet Resource for a full description of how data is looked up in the database. 


For more information, see Volume One, Chapter 11, Managing User Preferences. 
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Structures , 
XrmDatabase is a pointer to an opaque data typé. 


typedef XrmQuarkList XrmNameList; 
typedef XrmQuarkList XrmClassList; 
typedef XrmQuark XrmRepresentation; 


typedef struct { 
unsigned int size; 
caddr t addr; 
} XrmValue, *XrmValuePtr; 


Related Commands 
XrmDest royDatabase, XrmGetFileDatabase, XrmGetResource, XrmGet- 
StringDatabase, XrmInitialize, XrmMergeDatabases, XrmParseCommand, 
XrmPutFileDatabase, XrmPut LineResource, XrmPutResource, XrmPut— 
StringResource, XrmQGet SearchList, XrmQGetSearchResource, XrmQPut- 
Resource, XrmQPut StringResource, XrmQuarkToString, XrmString- 
ToBindingQuarkList, XrmStringToQuarkList, XrmStringToQuark, Xrm- 
UniqueQuark. 
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Name 
XrmQGetSearchList — return a list of database levels. 


Synopsis 
Bool XrmQGetSearchList (database, names, classes, 
search list, list_length) 
XrmDatabase database; 
XrmNameList names; 
XrmClassList classes; 
XrmSearchList search_list; /* RETURN */ 
int list_length; 


Arguments 
database Specifies the database to be searched. 
names Specifies a list of resource names. 
classes Specifies a list of resource classes. 


search list Returns a search list for further use. The caller must allocate sufficient space 
for the list before calling XxrmQGet SearchList. 


list length Specifies the number of entries (not the byte size) allocated for 
search list. 


Description 

XrmQGetSearchList is a tool for searching the database more efficiently. It is used in 
combination with XrmQGet SearchResource. Often, one searches the database for many 
similar resources which differ only in their final component (e.g., xmh.toc. foreground, 
xmh.toc.background, etc), Rather than looking for each resource in its entirety, Xrm- 
GetSearchList searches the database for the common part of the resource name, returning 
a whole list of items in the database that match it. This list is called the search list. This search 
list is then used by XrmQGet SearchList, which searches for the last components one at a 
time. In this way, the common work of searching for similar resources is done only once, and 
the specific part of the search is done on the much shorter search list. 


XrmQGetSearchList takes a list of names and classes and returns a list of database levels 
where a match might occur. The returned list is in best-to-worst order and uses the same algo- 
rithm as XrmGetResource for determining precedence. If search_list was large 
enough for the search list, XrmQGetSearchList returns True. Otherwise, it returns 
False. 


The size of the search list that must be allocated by the caller is dependent upon the number of 
levels and wildcards in the resource specifiers that are stored in the database. The worst case 
length is 3" , where n is the number of name or class components in names or classes. 


Only the common prefix of a resource name should be specified in the name and class list to 
XrmQGetSearchList. In the example above, the common prefix would be xmh.toc. 
However, note that XrmQGetSearchResource requires that name represent a single 
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component only. Therefore, the common prefix must be all but the last component of the name 
and class. A 


For more information, see Volume One, Chapter 11, Managing User Preferences. 


Structures 
XrmDatabase is a pointer to an opaque data type. 


typedef XrmQuarkList XrmNameList; 
typedef XrmQuarkList XrmClassList; _ 
typedef XrmQuark XrmRepresentation; 


XrmSearchList is a pointer to an opaque data type. 


Related Commands 
XrmDest royDatabase, XrmGetFileDatabase, XrmGetResource, XrmGet—- 
StringDatabase, XrmInitialize, XrmMergeDatabases, XrmParseCommand, 
XrmPutFileDatabase, XrmPutLineResource, XrmPutResource, XrmPut- 
StringResource, XrmQGetResource, XrmQGet SearchResource, XrmQPut— 
Resource, XrmQPut StringResource, XrmQuarkToString, XrmString- 
ToBindingQuarkList, XrmStringToQuarkList, XrmSt ringToQuark, Xrm- 
UniqueQuark. 
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Name 


XrmQGetSearchResource — search prepared list for a given resource. 


Synopsis 


Bool XrmQGetSearchResource (search _list, name, class, 
type, value) 
XrmSearchList search list; 
XrmName name; 
XrmClass class; 
XrmRepresentation *type; /* RETURN */ 


XrmValue *value; /* RETURN */ 
Arguments 
search _list Specifies the search list returned by XrcmQGetSearchList. 
name Specifies the resource name. 
class Specifies the resource class. 
type Returns the data representation type. 
value Returns the value from the database. 
Description 
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XrmQGetSearchResource is a tool for searching the database more efficiently. It is used 
in combination with XrmQGetSearchList. Often, one searches the database for many simi- 
lar resources which differ only in their final component (e.g., xmh.toc.foreground, 
xmh.toc.background, etc), Rather than looking for each resource in its entirety, Xrm- 
QGetSearchList searches the database for the common part of the resource name, returning 
a whole list of items in the database that match it. This list is called the search list. Xrm- 
QGetSearchResource searches the search list for the resource that is fully identified by 
name and class. The search stops with the first match. XxrmQGetSearchResource 
returns True if the resource was found; otherwise, it returns False. 


A call to XrmQGet SearchList with a name and class list containing all but the last compo- 
nent of a resource name followed by a call to XrmQGet SearchResource with the last com- 
ponent name and class returns the same database entry as XrmQGet Resource or XrmQGet - 
Resource would with the fully qualified name and class. 


For more information, see Volume One, Chapter 11, Managing User Preferences. 
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Structures 
XrmDatabase is a pointer to an opaque data type. 


typedef XrmQuark XrmName; 
typedef XrmQuark XrmClass; 
typedef XrmQuark XrmRepresentation; 


typedef struct { 
unsigned int size; 
caddr t addr; 
}. XrmValue, *XrmValuePtr; 


XrmSearchList Is a pointer to an opaque data type. 


Related Commands 
XrmDest royDatabase, XrmGetFileDatabase, XrmGetResource, XrmGet- 
StringDatabase, XrmInitialize, XrmMergeDatabases, XrmParseCommand, 
XrmPutFileDatabase, XrmPutLineResource, XrmPutResource, XrmPut- 
StringResource, XrmQGetResource, XrmQGetSearchList, XrmQPutResource, 
XrmQPutStringResource, XrmQuarkToString, XrmSt ringToBindingQuark- 
List, XrmStringToQuarkList, XrmStringToQuark, XrmUniqueQuark. 
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Name 
XrmQPutResource — store a resource specification into a database using quarks. 


Synopsis 
void XrmQPutResource (database, bindings, quarks, type, value) 
XrmDatabase *database; /* SEND, and if NULL, RETURN */ 
XrmBindingList bindings; 
XrmQuarkList quarks; 
XrmRepresentation type; 
XrmValue *value; 


Arguments 
database Specifies a pointer to the resource database. If database contains NULL, a new 
resource database is created and a pointer to it is returned in database. 


bindings Specifies a list of bindings for binding together the quarks argument. 


quarks Specifies the complete or partial name or class list of the resource to be stored. 
type Specifies the type of the resource. 
value Specifies the value of the resource. 

Description 


XrmQPut Resource stores a resource specification into the database. 


database can be a previously defined database, as returned by XrmGet StringDatabase, 
XrmGetFileDatabase, or from XrmMergeDatabases. If database is NULL, a new 
database is created and a pointer to it returned in database. 


bindings and quarks together specify where the value should be stored in the database. 
See XrmSt ringToBindingQuarkList for a brief description of binding and quark lists. 
See XrmGetResource for a description of the resource manager naming conventions and 
lookup rules. 


type is the representation type of value. This provides a way to distinguish between differ- 
ent representations of the same information. Representation types are user defined character 
strings describing the way the data is represented. For example, a color may be specified by a 
color name (“red”), or be coded in a hexadecimal string (‘““#4f6c84”) (if it is to be used as an 
argument to XParseColor.) The representation type would distinguish between these two. 
Representation types are created from simple character strings by using the macro Xrm- 
StringToRepresentation. The type XrmRepresentation is actually the same type 
as XrmQuark, since it is an ID for a string. The representation is stored along with the value 
in the database, and is returned when the database is accessed. 


value returns the value of the resource, specified as an XrmValue. 


XrmGetResource contains the complete description of how data is accessed from the data- 
base, and so provides a good perspective on how it is stored. 
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For more information, see Volume One, Chapter 11, Managing User Preferences. 


Structures 
XrmDatabase is a pointer to an opaque data type. 


typedef enum { 
XrmBindTightly, XrmBindLoosely 
} XrmBinding, *XrmBindingList; 


typedef int XrmQuark, *XrmQuarkList; 
typedef XrmQuarkList XrmNameList; 
typedef XrmQuark XrmRepresentation; 


typedef struct { 
unsigned int size; 
caddr_t addr; 

} XrmValue, *XrmValuePtr; 


Related Commands 
XrmDest royDatabase, XrmGetFileDatabase, XrmGetResource, XrmGet- 
StringDatabase, XrmInitialize, XrmMergeDatabases, XrmParseCommand, 
XrmPutFileDatabase, XrmPut LineResource, XrmPutResource, XrmPut-— 
StringResource, XrmQGetResource, XrmQGetSearchList, XrmQGetSearch- 
Resource, XrmQPutStringResource, XrmQuarkToString, XrmString- 
ToBindingQuarkList, XrmStringToQuarkList, XrmStringToQuark, Xrm- 
UniqueQuark. 
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Name 
XrmQPutStringResource — add a resource specification to a database using a quark resource 
name and string value. 


Synopsis 
void XrmQPutStringResource (database, bindings, quarks, value) 
XrmDatabase *database; /* SEND, and if NULL, RETURN */ 
XrmBindingList bindings; 
XrmQuarkList quarks; 
char *value; 


Arguments 
database Specifies a pointer to the resource database. If database contains NULL, a new 
resource database is created and a pointer to it is returned in database. 


bindings Specifies a list of bindings for binding together the quarks argument. 


quarks Specifies the complete or partial name or class list of the resource to be stored. 
value Specifies the value of the resource as a string. 
Description 


XrmQPut St ringResource stores a resource specification into the specified database. 


XrmQPutStringResource is a cross between XrmQPutResource and XrmPut- 
StringResource. Like XrmQPutResource, it specifies the resource by quarks and 
bindings, two lists that together make a name/class list with loose and tight bindings. Like 
XrmPut StringResource, it specifies the value to be stored as a string, that value is con- 
verted into an XrmValue, and the default representation type St ring is used. 


XrmPutResource, XrmQPutResource, XrmPutStringResource, XrmQPut- 
StringResource and XrmPutLineResource all store data into a database. See Xrm- 
QPutResource for the most complete description of this process. 


For more information, see Volume One, Chapter 11, Managing User Preferences. 


Structures 
XrmDatabase is a pointer to an opaque data type. 
typedef enum { 


XrmBindTightly, XrmBindLoosely 
} XrmBinding, *XrmBindingList; 


typedef int XrmQuark, *XrmQuarkList; 


Related Commands 
XrmDest royDatabase, XrmGetFileDatabase, XrmGetResource, XrmGet- 
StringDatabase, XrmInitialize, XrmMergeDatabases, XrmParseCommand, 
XrmPutFileDatabase, XrmPutLineResource, XrmPutResource, XrmPut- 
StringResource, XrmQGet Resource, XrmQGet SearchList, XrmQGetSearch- 
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Resource, XrmQPut Resource, XrmQuarkToString, XrmStringToBinding- 
QuarkList, XrmStringToQuarkList, XrmSt ringToQuark, XrmUniqueQuark. 
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Name 
XrmQuarkToString — convert a quark to a string. 


Synopsis 
char *XrmQuarkToString (quark) 
XrmQuark quark; 


Arguments 
quark Specifies the quark for which the equivalent string is desired. 


Description 
XrmQuarkToString returns the string for which the specified quark is serving as a short- 
hand symbol. The quark was earlier set to represent the string by XrcmSt ringToQuark. The 
string pointed to by the return value must not be modified or freed, because that string is in the 
data structure used by the resource manager for assigning quarks. If no string exists for that 
quark, XrmQuarkToString returns NULL. 


Since the resource manager needs to make many comparisons of strings when it gets data from 
the database, it is more efficient to convert these strings into quarks, and to compare quarks 
instead. Since quarks are represented by integers, comparing quarks is trivial. 


The three #define statements in the Structures section provide an extra level of abstraction. 
They define macros so that names, classes and representations can also be represented as 
quarks. 


For more information, see Volume One, Chapter 11, Managing User Preferences. 


Structures 
typedef int XrmQuark; 


/* macro definitions from <X11/Xresource.h> */ 


#define XrmNameToString(name) XrmQuarkToString (name) 
#define XrmClassToString(class) XrmQuarkToString(class) 
#define XrmRepresentationToString(type) XrmQuarkToString (type) 


Related Commands 
XrmDest royDatabase, XrmGetFileDatabase, XrmGetResource, XrmGet- 
StringDatabase, XrmInitialize, XrmMergeDatabases, XrmParseCommand, 
XrmPutFileDatabase, XrmPutLineResource, XrmPutResource, XrmPut- 
StringResource, XrmQGetResource, XrmQGetSearchList, XrmQGetSearch- 
Resource, XrmQPutResource, XrmQPut StringResource, XrmSt ring- 
ToBindingQuarkList, XrmStringToQuarkList, XrmSt ringToQuark, Xrm- 
UniqueQuark. 
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Name , 
XrmStringToBindingQuarkList — convert a key string to a binding list and a quark list. 


Synopsis 
XrmStringToBindingQuarkList (string, bindings, quarks) 
char *string; 
XrmBindingList bindings; /* RETURN */ 


XrmQuarkList quarks; /* RETURN */ 
Arguments 
string Specifies the string for which the list of quarks and list of bindings are to be 


generated. Must be NULL terminated. 


bindings Returns the binding list. The caller must allocate sufficient space for the 
binding list before the call. 


quark Returns the list of quarks. The caller must allocate sufficient space for the 
quarks list before the call. 


Description 

XrmSt ringToBindingQuarkList converts a resource specification string into two lists— 
one of quarks and one of bindings. Component names in the list are separated by a dot (“.”) 
indicating a tight binding or an asterisk (“*”) indicating a loose binding. If the string does not 
start with dot or asterisk, a dot (“‘.”) is assumed. 

A tight binding means that the quarks on either side of the binding are consecutive in the key. 
A loose binding, on the other hand, is a wildcard that can match any number of unspecified 
components in between the two quarks separated by the binding. Tight and loose bindings are 
used in the match rules, which compare multicomponent strings to find matches and determine 
the best match. See XrmGet Resource for a full description of lookup rules. 


For example, *a .b*c becomes: 


quarks _ bindings 


"a" XrmBindLoosely 
"pb" XrmBindTightly 
"e" XrmBindLoosely 


For more information, see Volume One, Chapter 11, Managing User Preferences. 


Structures 
typedef int XrmQuark, *XrmQuarkList; 
typedef enum ( 
XrmBindLoosely, XrmBindTightly 
) XrmBinding, *XrmBindingList; 


Xlib Reference Manual ‘ 407 


XrmStringToBindingQuarkList (continued) Xlib — Resource Manager 


Related Commands 
XrmDest royDatabase, XrmGetFileDatabase, XrmGetResource, XrmGet-— 
StringDatabase, XrmInitialize, XrmMergeDatabases, XrmParseCommand, 
XrmPutFileDatabase, XrmPutLineResource, XrmPutResource, XrmPut- 
StringResource, XrmQGetResource, XrmQGetSearchList, XrmQGetSearch- 
Resource, XrmQPutResource, XrmQPutStringResource, XrmQuarkToString, 
XrmStringToQuarkList, XrmStringToQuark, XrmUniqueQuark. 
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Name ‘ 
XrmStringToQuark — convert a string to a quark.‘ 


Synopsis 
XrmQuark XrmStringToQuark (string) 
char *string; 


Arguments 
. string Specifies the string for which a quark is to be allocated. 


Description ; 
XrmStringToQuark returns a quark that will represent the specified string. If a quark 
already exists for the string, that previously existing quark is returned. If no quark exists for the 
string, then a new quark is created, assigned to the string, and st ring is copied into the quark 
table. (Since st ring is copied, it may be freed. However, the copy of the string in the quark 
table must not be modified or freed.) XrmQuarkToSt ring performs the inverse function. 


Since the resource manager needs to make many comparisons of strings when it gets data from 
the database, it is more efficient to convert these strings into quarks, and to compare quarks 
instead. Since quarks are presently represented by integers, comparing quarks is trivial. 


The three #define statements in the Structures section provide an extra level of abstraction. 
They define macros so that names, classes, and representations can also be represented as 
quarks. 


For more information, see Volume One, Chapter 11, Managing User Preferences. 


Structures 
typedef int XrmQuark; 


/* macro definitions from <X11/Xresource.h> */ 


#define XrmStringToName (string) XrmStringToQuark (string) 
#define XrmStringToClass(string) XrmStringToQuark (string) 
#define XrmStringToRepresentation(string) XrmStringToQuark (string) 


Related Commands 
XrmDest royDatabase, XrmGetFileDatabase, XrmGetResource, XrmGet- 
StringDatabase, XrmInitialize, XrmMergeDatabases, XrmParseCommand, 
XrmPutFileDatabase, XrmPutLineResource, XrmPutResource, XrmPut- 
StringResource, XrmQGetResource, XrmQGetSearchList, XrmQGet Search- 
Resource, XrmQPutResource, XrmQPutStringResource, XrmQuarkToString, 
XrmSt ringToBindingQuarkList, XrmStringToQuarkList, XrmUniqueQuark. 
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Name 


XrmStringToQuarkList — convert a key string to a quark list. 


Synopsis 


void XrmStringToQuarkList (string, quarks) 
chars “srring; 


XrmQuarkList quarks; /* RETURN */ 
Arguments 
string Specifies the string for which a list of quarks is to be generated. Must be null- 


terminated. The components may be separated by the “.” character (tight 
binding) or the “*” character (loose binding). 


quarks Returns the list of quarks. 


Description 


XrmSt ringToQuarkList converts string (generally a fully qualified name/class string) 
to a list of quarks. Components of the string may be separated by a tight binding (the “.” char- 
acter) or a loose binding (“*”). Use XrmStringToBindingQuarkList for lists which 
contain both tight and loose bindings. See XrmGetResource for a description of tight and 


loose binding. 


Each component of the string is individually converted into a quark. See XrmString- 
ToQuark for information about quarks and converting strings to quarks. quarks is a null- 
terminated list of quarks. 


For example, xmh.toc.command.background is converted into a list of four quarks: the 
quarks for xmh, toc, command, and background, in that order. A NULLQUARK is appended 
to the end of the list. 


Note that XrmStringToNameList and XrmStringToClassList are macros that per- 
form exactly the same function as XrmSt ringToQuarkList. These may be used in cases 
where they clarify the code. 


For more information, see Volume One, Chapter 11, Managing User Preferences. 


Structures 
typedef int XrmQuark *XrmQuarkList; 
#define XrmStringToNameList(str, name) XrmStringToQuarkList((str), (name) ) 
#define XrmStringToClassList (str,class) XrmStringToQuarkList((str), (class) ) 
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Related Commands 
XrmDest royDatabase, XrmGetFileDatabase, XrmGetResource, XrmGet- 
StringDatabase, XrmInitialize, XrmMergeDatabases, XrmParseCommand, 
XrmPutFileDatabase, XrmPutLineResource, XrmPutResource, XrmPut-—- 
StringResource, XrmQGetResource, XrmQGetSearchList, XrmQGet Search- 
Resource, XrmQPut Resource, XrmQPutStringResource, XrmQuarkToString, 
XrmSt ringToBindingQuarkList, XrmSt ringToQuark, XrmUniqueQuark. 
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Name 


XrmUniqueQuark — allocate a new quark. 


Synopsis 


XrmQuark XrmUniqueQuark ( ) 


Description 


XrmUniqueQuark allocates a quark that is guaranteed not to represent any existing string. 
For most applications, XrmSt ringToQuark is more useful, as it binds a quark to a string. 
However, on some occasions, you may want to allocate a quark that has no string equivalent. 


The shorthand name for a string is called a quark and is the type XrmQuark. Quarks are used 
to improve performance of the resource manager, which must make many string comparisons. 
Quarks are presently represented as integers. Simple comparisons of quarks can be performed 
rather than lengthy string comparisons. 


A quark is to a string what an atom is to a property name in the server, but its use is entirely 
local to your application. 


For more information, see Volume One, Chapter 11, Managing User Preferences. 


Structures 


typedef int XrmQuark; 


Related Commands 
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xXrmDest royDatabase, XrmGetFileDatabase, XrmGetResource, XrmGet- 
StringDatabase, XrmInitialize, XrmMergeDatabases, XrmParseCommand, 
XrmPutFileDatabase, XrmPut LineResource, XrmPutResource, XrmPut- 
StringResource, XrmQGet Resource, XrmQGet SearchList, XrmOQGet Search- 
Resource, XrmQPutResource, XrmQPutStringResource, XrmQuarkToString, 
XrmSt ringToBindingQuarkList, XrmStringToQuarkList, XrmStringTo- 
Quark. 
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Name . 
XRotateBuffers — rotate the cut buffers. 
Synopsis 
XRotateBuffers (display, rotate) 
Display *display; 
int rotate; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
rotate Specifies how many positions to rotate the cut buffers. 

Description 


XRotateBuffers rotates the 8 cut buffers the amount specified by rotate. The contents 
of buffer 0 moves to buffer rotate, contents of buffer 1 moves to buffer (rotate+1) mod 8, 
contents of buffer 2 moves to buffer (rot at e+2) mod 8, and so on. 


This routine will not work if any of the buffers have not been stored into with XStoreBuffer 
or XStoreBytes. 


This cut buffer numbering is global to the display. 


See the description of cut buffers in Volume One, Chapter 13, Other Programming Techniques. 


Related Commands 
XFetchBuffer, XFetchBytes, XStoreBuffer, XStoreBytes. 
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Name 


XRotateWindowProperties — rotate properties in the properties array. 


Synopsis 


XRotateWindowProperties (display, w, properties, num_prop, 
npositions) 
Display *display; 
Window w; 
Atom properties []; 
int num_prop; 
int npositions; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
w Specifies the ID of the window whose properties are to be rearranged. 


properties Specifies the list of properties to be rotated. 
num_prop Specifies the length of the properties array. 


npositions Specifies the number of positions to rotate the property list. The sign controls 
the direction of rotation. 


Description 


XRotateWindowProperties rotates the contents of an array of properties on a window. If 
the property names in the properties array are viewed as if they were numbered starting 
from 0 and if there are num_prop property names in the list, then the value associated with 
property name J becomes the value associated with property name (J + npositions) mod 
num_prop, for all J from 0 to num_prop — 1. Therefore, the sign of npositions controls 
the direction of rotation. The effect is to rotate the states by npositions places around the 
virtual ring of property names (right for positive npositions, left for negative nposi- 
tion). 


If npositions mod num_prop is nonzero, a PropertyNotify event is generated for 
each property, in the order listed. 


If a BadAtom, BadMatch, or BadWindow error is generated, no properties are changed. 


Error 
BadAtom Atom occurs more than once in list for the window. 
No property with that name for the window. 
BadMatch An atom appears more that once in the list or no property with that name is 
defined for the window. 
BadWindow 
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Related Commands ' 
XChangeProperty, XDeleteProperty, XGetAtomName, XGetFontProperty, 
XGetWindowProperty, XInternAtom, XListProperties, XSetStandard- 
Properties. 
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Name 
XSaveContext — save a data value corresponding to a window and context type (not graphics 
context). 
Synopsis 


int XSaveContext (display, w, context, data) 
Display *display; 
Window w; 
XContext context; 
caddr t data; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
Ww Specifies the ID of the window with which the data is associated. 
context Specifies the context type to which the data corresponds. 
data Specifies the data to be associated with the window and context. 
Description 


XSaveContext saves data to the context manager database, according to the specified win- 
dow and context ID. The context manager is used for associating data with windows within 
an application. The client must have called XUniqueContext to get the context ID 
before calling this function. The meaning of the data is indicated by the context ID, but is 
completely up to the client. 


If an entry with the specified window and context ID already exists, XSaveContext writes 
over it with the specified data. 


The XSaveContext function returns XCNOMEM (a nonzero error code) if an error has occurred 
and zero (0) otherwise. For more information, see the description of the context manager in 
Volume One, Chapter 13, Other Programming Techniques. 


Structures 
typedef int XContext; 


Related Commands 
XDeleteContext, XFindContext, XUniqueContext. 
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Name 
XSelectInput — select the event types to be sent to a window. 


Synopsis 
XSelectInput (display, w, event_mask) 
Display *display; 
Window w; 
long event_mask; 


Arguments 


display Specifies a connection to an X server; returned from XOpenDisplay. 
w Specifies the ID of the window interested in the events. 


event_mask Specifies the event mask. This mask is the bitwise OR of one or more of the 
valid event mask bits (see below). 


Description 
XSelectInput defines which input events the window is interested in. If a window is not 
interested in a device event (button, key, motion, or border crossing), it propagates up to the 
closest ancestor unless otherwise specified in the do_not_propagate_mask attribute. 


The bits of the mask are defined in <X/1/X.h>: 


ButtonPressMask NoEventMask 
ButtonReleaseMask KeyPressMask 
EnterWindowMask KeyReleaseMask 
LeaveWindowMask ExposureMask 
PointerMotionMask VisibilityChangeMask 
PointerMotionHintMask StructureNotifyMask 
Button1lMotionMask ResizeRedirectMask 
Button2Mot ionMask Subst ructureNotifyMask 
Button3MotionMask Subst ructureRedirectMask 
Button4MotionMask FocusChangeMask 
Button5MotionMask PropertyChangeMask 
ButtonMotionMask ColormapChangeMask 
KeymapStateMask OwnerGrabButtonMask 


A call on XSelect Input overrides any previous call on XSelect Input for the same win- 
dow from the same client but not for other clients. Multiple clients can select input on the same 
window; their event_mask window attributes are disjoint. When an event is generated it will 
be reported to all interested clients. However, only one client at a time can select for each of 
SubstructureRedirectMask, ResizeRedirectMask, and ButtonPress. 


If a window has both ButtonPressMask and ButtonReleaseMask selected, then a 
ButtonPress event in that window will automatically grab the mouse until all buttons are 
released, with events sent to windows as described for XGrabPointer. This ensures that a 
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window will see the ButtonRelease event corresponding to the ButtonPress event, 
even though the mouse may have exited the window in the meantime. 


If PointerMotionMask is selected, events will be sent independent of the state of the 
mouse buttons. If instead, one or more of Button1MotionMask, Button2Mot ionMask, 
Button3MotionMask, Button4MotionMask, Button5MotionMask is selected, 
MotionNotify events will be generated only when one or more of the specified buttons is 
depressed. 


XCreateWindow and XChangeWindowAttributes can also set the event_mask attri- 
bute. 


For more information, see Volume One, Chapter 8, Events. 


Errors 
BadValue Specified event mask invalid. 
BadWindow , 
Related Commands 


QLength, XAllowEvents, XCheckIfEvent, XCheckMaskEvent, XCheckTyped- 
Event, XCheckTypedWindowEvent, XCheckWindowEvent, XEventsQueued, 
XGet InputFocus, XGetMotionEvents, XIfEvent, XMaskEvent, XNextEvent, 
XPeekEvent, XPeekIfEvent, XPending, XPutBackEvent, XSendEvent, XSet- 
InputFocus, XSynchronize, XWindowEvent. 
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Name 
XSendEvent — send an event. : 


Synopsis 
Status XSendEvent (display, w, propagate, event_mask, event) 
Display *display; 
Window w; 
Bool propagate; 
long event_mask; 
XEvent *event; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
w Specifies the ID of the window where you want to send the event. Pass the 


window resource ID, PointerWindow, or InputFocus. 


propagate Specifies how the sent event should propagate depending on event_mask. 
See description below. May be True or False. 


event_mask Specifies the event mask. See XSelectInput for a detailed list of the 


event masks. 
event Specifies a pointer to the event to be sent. 
Errors 
BadValue Specified event is not a valid core or extension event type, or event mask is 
invalid. 
BadWindow 


Description 

' XSendEvent sends an event from one client to another (or conceivably to itself). This func- 
tion is used for communication between clients using selections, for simulating user actions in 
demos, and for other purposes. 


The specified event is sent to the window indicated by w regardless of active grabs. 


If wis set to PointerWindow, the destination of the event will be the window that the pointer 
is in. If wis InputFocus is specified, then the destination is the focus window, regardless of 
pointer position. 


If propagate is False, then the event is sent to every client selecting on the window speci- 
fied by w any of the event types in event_mask. If propagate is True and no clients have 
been selected on w any of the event types in event_mask, then the event propagates like any 
other event. 

The event code must be one of the core events, or one of the events defined by a loaded exten- 
sion, so that the server can correctly byte swap the contents as necessary. The contents of the 
event are otherwise unaltered and unchecked by the server. The send_event field in every 
event type, which if True indicates that the event was sent with XSendEvent. 
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This function is often used in selection processing. For example, the owner of a selection 
should use XSendEvent to send a SelectionNotify event to a requestor when a selec- 
tion has been converted and stored as a property. See Volume One, Chapter 10, Interclient 
Communication for more information. 


The status returned by XSendEvent indicates whether or not the given XEvent structure was 
successfully converted into a wire event. This value is zero on failure, or nonzero on success. 
Along with changes in the extensions mechanism, this makes merging of two wire events into a 
single user-visible event possible. 


Structures 


See Appendix E, Event Reference, for the contents of each event structure. 


Related Commands 
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QLength, XAllowEvents, XCheckIfEvent, XCheckMaskEvent, XCheckTyped- 
Event, XCheckTypedWindowEvent, XCheckWindowEvent, XEvent sQueued, 
XGet InputFocus, XGetMotionEvents, XIfEvent, XMaskEvent, XNextEvent, 
XPeekEvent, XPeekIfEvent, XPending, XPutBackEvent, XSelect Input, XSet- 
InputFocus, XSynchronize, XWindowEvent. 
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Name } 
XSetAccessControl — disable or enable access corttrol. 
Synopsis 
XSetAccessControl (display, mode) 
Display *display; 


int mode; 
Arguments 
display Specifies a connection to an.X server; returned from XOpenDisplay. 
mode Specifies whether you want to enable or disable the access control. Pass one 


of these constants: EnableAccess or DisableAccess. 


Description 
XSetAccessControl specifies whether the server should check the host access list before 
allowing access to clients running on remote hosts. If the constant used is DisableAccess, 
clients from any host have access unchallenged. 


This routine can only be called from a client running on the same host as the server. 
For more information on access control lists, see Volume One, Chapter 13, Other Programming 
Techniques. 


Errors 
BadAccess 
BadValue 


Related Commands 


XAddHost, XAddHosts, XDisableAccessControl, XEnableAccessControl, 
XListHosts, XRemoveHost, XRemoveHosts. 
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Name 
XSetAfterFunction — set a function called after all Xlib functions. 


Synopsis 
int (*XSetAfterFunction (display, func)) () 
Display *display; 
ane. (se foncy():; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
func Specifies the user-defined function to be called after each Xlib function. This 
function is called with one argument, the display pointer. 
Description 


All Xlib functions that generate protocol requests can call what is known as an after function 
after completing their work (normally, they don’t), XSetAfterFunction allows you to 
write a function to be called. 


XSynchronize sets an after function to make sure that the input and request buffers are 
flushed after every Xlib routine. 


For more information, see Volume One, Chapter 13, Other Programming Techniques. 
Related Commands 


XDisplayName, XGetErrorDatabaseText, XGetErrorText, XSetError- 
Handler, XSet I0ErrorHandler, XSynchronize. 


422 Xlib Reference Manual 


— Xlib — Graphics Context XSetArcMode 


Name 
XSetArcMode — set the arc mode in a graphics context. 
Synopsis 
XSetArcMode (display, gc, arc_mode) 
Display *display; 
SC: GC; 
int arc_mode; 


Arguments 
display Specifies a connection to an-X server; returned from XOpenDisplay. 
gc Specifies the graphics context. 
arc_mode Specifies the arc mode for the specified graphics context. Possible values are 
ArcChord orArcPieSlice. 
Description 


XSetArcMode sets the arc_mode component of a GC, which controls filling in the XFil1- 
Arcs function. ArcChord specifies that the area between the arc and a line segment joining 
the endpoints of the arc is filled. ArcPieSlice specifies that the area filled is delimited by 
the arc and two line segments connecting the ends of the arc to the center point of the rectangle 
defining the arc. 





ArcChord ArcPieSlice 
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Errors 
BadGC 
BadValue 


Related Commands 
DefaultGC, XChangeGC, XCopyGC, XCreateGC, XFreeGC, XGContextFromGc, 
XSetBackground, XSetClipMask, XSetClipOrigin, XSetClipRectangles, 
XSetDashes, XSetFillRule, XSetFillStyle, XSetForeground, XSet- 
Function, XSetGraphicsExposures, XSetLineAttributes, XSetPlaneMask, 
XSet State, XSetStipple, XSet SubwindowMode, XSetTSOrigin. 
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Name 
XSetBackground — set the background pixel value in a graphics context. 
Synopsis 
XSetBackground (display, gc, background) 
Display *display; 
GE" gC; 
unsigned long background; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
gc Specifies the graphics context. 


background Specifies the background component of the GC. 


Description 
XSetBackground sets the background pixel value component of a GC. Note that this is 
different from the background of a window, which can be set with either XSetWindow- 
Background or XSetWindowBackgroundPixmap. 


The specified pixel value must be returned by BlackPixel, WhitePixel, or one of the rou- 
tines that allocate colors. 


Errors 
BadGC 


Related Commands 
DefaultGC, XChangeGC, XCopyGC, XCreateGC, XFreeGC, XGContextFromGC, 
XSetArcMode, XSetClipMask, XSetClipOrigin, XSetClipRectangles, XSet- 
Dashes, XSetFillRule, XSetFillStyle, XSetForeground, XSetFunction, 
XSetGraphicsExposures, XSetLineAttributes, XSetPlaneMask, XSetState, 
XSetStipple, XSet SubwindowMode, XSetTSOrigin. 
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Name 
XSetClassHint — set the XA_WM_CLASS property of a window. 


Synopsis 
XSetClassHint (display, w, class_hints) 
Display *display; 
Window w; 
XClassHint *class_hints; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
w Specifies the ID of the window for which the class hint is to be set. 


class_hints Specifies the XClassHint structure that is to be used. 


Description : 
XSetClassHint sets the XA_WM CLASS property for the specified window. The window 
manager may (or may not) read this property, and use it to get resource defaults that apply to 
the window manager’s handling of this application. 


The XClassHint structure set contains res_class, which is the name of the client such as 
“emacs”, and res_name, which is the first of the following that applies: 


° command line option (-rn name) 
° a specific environment variable (e.g., RESOURCE_NAME) 
° the trailing component of argv [0] (after the last /) 


For more information, see Volume One, Chapter 10, /nterclient Communication. 


Errors 
BadAlloc 
BadWindow 


Structures 
typedef struct { 
char *res name; 
Chale nnresncilass, 
} XClassHint; 


Related Commands 
XAllocClassHint, XFetchName, XGetClassHint, XGetIconName, XGetIcon- 
Sizes, XGetNormalHints, XGetSizeHints, XGetTransientForHint, XGet- 
WMHints, XGet ZoomHints, XSetCommand, xXSet IconName, XSetIconSizes, 
XSetNormalHints, XSetSizeHints, XSetTransientForHint, XSetWMHints, 
XSet ZoomHints, XStoreName, XSetWMProperties. 
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— Xlib —- Graphics Context XSetClipMask 


Name 
XSetClipMask — set clip_mask pixmap in a graphics context. 
Synopsis . 
XSetClipMask (display, gc, clip_mask) 
Display *display; 
Gouge, 
Pixmap clip mask; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
gc Specifies the graphics context. 


clip mask Specifies a pixmap of depth 1 to be used as the clip mask. Pass the constant 
None if no clipping is desired. . 


Description 
XSetClipMask sets the clip mask component of a GC toa pixmap. The clip_mask fil- 
ters which pixels in the destination are drawn. If clip _mask is set to None, the pixels are 
always drawn, regardless of the clip origin. Use XSet ClipRectangles to set clip mask 
to a set of rectangles, or XSet Region to set clip_mask toa region. 


For more information, see Volume One, Chapter 5, The Graphics Context. 


Errors 
BadGC 
BadMatch 
BadPixmap 


Related Commands 

DefaultGC, XChangeGC, XCopyGC, XCreateGC, XFreeGC, XGContextFromGC, 
XSetArcMode, XSetBackground, XSetClipOrigin, XSetClipRectangles, 
XSetDashes, XSetFillRule, XSetFillStyle, XSetForeground, XSet- 
Function, XSetGraphicsExposures, XSetLineAttributes, XSetPlaneMask, 
XSetState, XSetStipple, XSet SubwindowMode, XSetTSOrigin. 
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Name 
XSetClipOrigin — set the clip origin in a graphics context. 


Synopsis 
XSetClipOrigin (display, gc, clip_x_origin, clip_y_ origin) 
Display *display; 
(eS Cte7 
Unteclip x Origin, Clip y origin; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
gc Specifies the graphics context. 


clip x origin Specify the coordinates of the clip origin (interpreted later relative to the 
clip y origin window drawn into with this GC). 


Description 
XSetClipOrigin sets the clip_x_originand clip _y origin components of a GC. 
The clip origin controls the position of the clip_mask in the GC, which filters which pixels 
are drawn in the destination of a drawing request using this GC. 


For more information, see Volume One, Chapter 5, The Graphics Context. 


Errors 
BadGC 


Related Commands 
DefaultGC, XChangeGC, XCopyGC, XCreateGC, XFreeGC, XGContextFromGC, 
XSetArcMode, XSetBackground, XSetClipMask, XSetClipRectangles, XSet- 
Dashes, XSetFillRule, XSetFillStyle, XSetForeground, XSetFunction, 
XSetGraphicsExposures, XSetLineAttributes, XSetPlaneMask, XSetState, 
XSetStipple, XSet SubwindowMode, XSetTSOrigin. 
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Name 
XSetClipRectangles — change clip_mask ina graphics context to a list of rectangles. 


Synopsis 
XSetClipRectangles (display, gc, clip_x origin, 
clip _y origin, rectangles, nrects, ordering) 
Display *display; 
Ge. gc; 
int clipyx origin, clip iy origin; 
XRectangle rectangles[]; 
int nrects; 
int ordering; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
gc Specifies the graphics context. 


clip x_origin Specify the x and y coordinates of the clip origin (interpreted later rela- 
clip_y_ origin tive to the window drawn into with this GC). 


rectangles Specifies an array of rectangles. These are the rectangles you want draw- 
ing clipped to. 

nrects Specifies the number of rectangles. 

ordering Specifies the ordering relations of the rectangles. Possible values are 


Unsorted, YSorted, YXSorted, or YXBanded. 


Description 
XSetClipRectangles changes the clip mask component in the specified GC to the 
specified list of rectangles and sets the clip origin to clip_x origin and clip y ori- 
gin. The rectangle coordinates are interpreted relative to the clip origin. The output from 
drawing requests using that GC are henceforth clipped to remain contained within the rectan- 
gles. The rectangles should be nonintersecting, or the graphics results will be undefined. If the 
list of rectangles is empty, output is effectively disabled as all space is clipped in that GC. This 
is the opposite of aclip_mask of None in XCreateGC, XChangeGC, or XSetClipMask. 


If known by the client, ordering relations on the rectangles can be specified with the order- 
ing argument. This may provide faster operation by the server. If an incorrect ordering is 
specified, the X server may generate a BadMatch error, but it is not required to do so. If no 
error is generated, the graphics results are undefined. Unsorted means the rectangles are in 
arbitrary order. YSorted means that the rectangles are nondecreasing in their y origin. 
YXSorted additionally constrains YSorted order in that all rectangles with an equal y origin 
are nondecreasing in their x origin. YXBanded additionally constrains YxSorted by requir- 
ing that, for every possible horizontal y scan line, all rectangles that include that scan line have 
identical y origins and y extents. 
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To cancel the effect of this command, so that there is no clipping, pass None as the 
clip mask in XChangeGC or XSetClipMask. 


For more information, see Volume One, Chapter 5, The Graphics Context. 


Structures 
typedef struct { 
Short xvas 
unsigned short width, height; 
} XRectangle; 


Errors 
BadAlloc 


BadGC 
BadMatch Incorrect ordering (error message server-dependent). 
BadValue 


Related Commands 
DefaultGC, XChangeGC, XCopyGC, XCreateGC, XFreeGC, XGContextFromGC, 
XSetArcMode, XSet Background, XSetClipMask, XSetClipOrigin, xSet- 
Dashes, XSetFillRule, XSetFillStyle, XSetForeground, XSetFunction, 
XSetGraphicsExposures, XSetLineAttributes, XSetPlaneMask, XSetState, 
XSetStipple, XSet SubwindowMode, XSetTSOrigin. 
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—Xlib — Client Connections XSetCloseDownMode 


Name 
XSetCloseDownMode — change the close down mode of a client. 


Synopsis 
XSetCloseDownMode (display, close_mode) 
Display *display; 
int close_mode; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 


close_mode Specifies the client close down mode you want. Pass one of these constants: 
Dest royAll, RetainPermanent, or RetainTemporary. 


Description 

XSetCloseDownMode defines what will happen to the client’s resources at connection close. 
A connection between a client and the server starts in Dest royAll mode, and all resources 
associated with that connection will be freed when the client process dies. If the close down 
mode is RetainTemporary or RetainPermanent when the client dies, its resources live 
on until a call to XKillClient. The resource argument of XKil1Client can be used to 
specify which client to kill, or it may be the constant All Temporary, in which case XKill- 
Client kills all resources of all clients that have terminated in RetainTemporary mode. 


One use of RetainTemporary or RetainPermanent might be to allow an application to 
recover from a failure of the network connection to the display server. After restarting, the 
application would need to be able to identify its own resources and reclaim control of them. 


Errors 
BadValue 


Related Commands 
XKillClient. 
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Name 
XSetCommand — set the XA_WM COMMAND atom (command line arguments). 


Synopsis 
XSetCommand (display, w, argv, argc) 
Display *display; 
Window w; 
Chala Aang, 
ant. argc; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
Ww Specifies the ID of the window whose atom is to be set. 
argv Specifies a pointer to the command and arguments used to start the application. 
arge Specifies the number of arguments. 
Description 


XSetCommand is superseded by XSet WMCommand in Release 4. 


XSetCommand is used by the application to set the XA_WM_COMMAND property for the window 
manager with the command and its arguments used to invoke the application. 


XSetCommand creates a zero-length property if argc is zero. 


Use. this command only if not calling XSetStandardProperties or XSet- 
WMP roperties. 


Errors 
BadAlloc 
BadWindow 


Related Commands 
XFetchName, XGetClassHint, XGetIconName, XGetIconSizes, XGetNormal- 
Hints, XGetSizeHints, XGetTransientForHint, XGetWMHints, XGet Zoom- 
Hints, XSetClassHint, XSetIconName, XSetIconSizes, XSetNormalHints, 
XSetSizeHints, XSetTransientForHint, XSetWMHints, XSetZoomHints, 
XStoreName. 


432 Xlib Reference Manual 


— Xlib - Graphics Context XSetDashes 


Name 
XSetDashes — set a pattern of line dashes in a graphics context. 
Synopsis 
XSéetDashes (display, gc, dash_offset, dash_list, n) 
Display *display; 
GC gcy 
int dash offset; 
char dash’ Jisehiy 


Sigh wal s 
Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
gc Specifies the graphics context. 


dash_offset Specifies the phase of the pattern for the dashed line style. 


dash_list Specifies the dash list for the dashed line style. An odd-length list is equiva- 
lent to the same list concatenated with itself to produce an even-length list. 


n Specifies the length of the dash list argument. 
First pixel Last pixel 
in line in line 


dotted (3,1) 


clos Wlaisinec! (i, 317, 1) 


short dashed (4, 4) 


long dashed (4,7) 


odds daisied: {N27 2)) 




















2 654556 7S. O10 Mie Tat 41Sd6i7 1819: 202122 


Pixels 
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Description 


XSetDashes sets the dashes component of a GC. The initial and alternating elements of 
the dash_list argument are the dashes, the others are the gaps. All of the elements must be 
nonzero, with lengths measured in pixels. The dash_offset argument defines the phase of 
the pattern, specifying how many pixels into the dash_list the pattern snout actually begin 
in the line drawn by the request. 


n specifies the length of dash_list. An odd value for n is interpreted as specifying the 
dash_list concatenated with itself to produce twice as long a list. 


Ideally, a dash length is measured along the slope of the line, but server implementors are only 
required to match this ideal for horizontal and vertical lines. Failing the ideal semantics, it is 
suggested that the length be measured along the major axis of the line. The major axis is 
defined as the x axis for lines drawn at an angle of between -45 and +45 degrees or between 
315 and 225 degrees from the x axis. For all other lines, the major axis is the y axis. 


See Volume One, Chapter 5, The Graphics Context, for further information. 


Errors 


BadAlloc 
BadGC 


BadValue No values in dash_list. 
Element in dash_list is 0. 


Related Commands 
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DefaultGC, XChangeGC, XCopyGC, XCreateGC, XFreeGC, XGContextFromGC, 
XSetArcMode, XSetBackground, XSetClipMask, XSetClipOrigin, XSetClip- 
Rectangles, XSetFillRule, XSetFillStyle, xSetForeground, XSet- 
Function, XSetGraphicsExposures, XSetLineAttributes, XSetPlaneMask, 
XSetState, XSetStipple, XSet SubwindowMode, XSetTSOrigin. 
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Name 
XSetErrorHandler — set a nonfatal error event handler. 
Synopsis 
In Release 3: 
XSetErrorHandler (handler) 
int (* handler) (Display *, XErrorEvent *) 
In Release4: int (*XSetErrorHandler (handler) ) () 
int (* handler) (Display *, XErrorEvent *) 


Arguments 
handler The user-defined function to be called to handle error events. If a NULL 
pointer, reinvoke the default handler, which prints a message and exits. 
Description 


The error handler function specified in handler will be called by Xlib whenever an XError 
event is received. These are nonfatal conditions, such as unexpected values for arguments, or a 
failure in server memory allocation. It is acceptable for this procedure to return, though the 
default handler simply prints a message and exits. However, the error handler should NOT per- 
form any operations (directly or indirectly) on the server. 


In Release 4, XSetErrorHandler returns a pointer to the previous error handler. 


The function is called with two arguments, the display variable and a pointer to the XError- 
Event structure. Here is a trivial example of a user-defined error handler: 


int myhandler (display, myerr) 

Display *display; 

XErrorEvent *myerr; 

{ 
char msg[80]; 
XGetErrorText (display, myerr->error code, msg, 80); 
fprinti (stderr, “Error code %s\n", msc); 


} 
This is how the example routine would be used in XSetErrorHandler. 
XSetErrorHandler (myhandler) ; 


Note that XSetErrorHandler is one of the few routines that does not require a display 
argument. The routine that calls the error handler gets the display variable from the XError- 
Event structure. 


The error handler is not called on BadName errors from OpenFont, LookupColor, and 
AllocNamedColor protocol requests, on BadFont errors from a QueryFont protocol 
request, or on BadAlloc or BadAccess errors. These errors are all indicated by Status 
return value of zero in the corresponding Xlib routines, which must be caught and handled by 
the application. 


Use XIOErrorHandler to provide a handler for I/O errors such as network failures or server 
host crashes. 5 
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(continued) Xlib — Error Handling 


In the XErrorEvent structure shown below, the serial member is the number of requests 
(starting from 1) sent over the network connection since it was opened. It is the number that 
was the value of the request sequence number immediately after the failing call was made. The 
request_code member is a protocol representation of the name of the procedure that failed 
and is defined in <X/11/X.h>. 


For more information, see Volume One, Chapter 3, Basic Window Program. 


Structures 
typedef struct { 
int type 
Display *display; /* display the event was read from */ 
XID resourceid; /*x resource) ID» */ 


unsigned long 

unsigned char 

unsigned char 

unsigned char 
} XErrorEvent; 


Related Commands 
XDisplayName, XGetErrorDatabaseText, XGetErrorText, XSetAfter- 
Function, XSetIOErrorHandler, XSynchronize. 
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serial; /* serial number of failed request */ 
error code;/* error code of failed request */ 
request_code;/* major opcode of failed request */ 
minor code;/* minor opcode of failed request */ 
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—Xlib — Graphics Context XSetFillRule 


Name 
XSetFillRule — set the fill rule in a graphics context, 


Synopsis 
XSetFillRule (display, gc, fill_rule) 
Display *display; 
GC gc; 
int fill_rule; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
gc Specifies the graphics context. 


fill_rule Specifies the fill rule you want to set for the specified graphics context. Pos- 
sible values are EvenOddRule or WindingRule. 


Description 

%SetFillRule sets the fill_rule component of aGC. The fil1_rule member of the 
GC determines what pixels are drawn in XFil1lPolygon requests. Simply put, Winding- 
Rule fills overlapping areas of the polygon, while EvenOddRule does not fill areas that 
overlap an odd number of times. Technically, EvenOddRule means that the point is drawn if 
an arbitrary ray drawn from the point would cross the path determined by the request an odd 
number of times. WindingRule indicates that a point is drawn if a point crosses an unequal 
number of clockwise and counterclockwise path segments, as seen from the point. 





WindingRule 


Outline of polygon to fill 
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A clockwise-directed path segment is one which crosses the ray from left to right as observed 
from the point. A counterclockwise segment is one which crosses the ray from right to left as 
observed from the point. The case where a directed line segment is coincident with the ray is 
uninteresting because you can simply choose a different ray that is not coincident with a seg- 
ment. 


All calculations are performed on infinitely small points, so that if any point within a pixel is 
considered inside, the entire pixel is drawn. Pixels with centers exactly on boundaries are con- 
sidered inside only if the filled area is to the right, except that on horizontal boundaries, the 
pixel is considered inside only if the filled area is below the pixel. 


See Volume One, Chapter 5, The Graphics Context, for more information. 


Errors 


BadGC 
BadValue 


Related Commands 
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DefaultGC, XChangeGC, XCopyGC, XCreateGC, XFreeGC, XGContextFromGC, 
XSetArcMode, XSetBackground, XSetClipMask, XSetClipOrigin, XSetClip- 
Rectangles, XSetDashes, XSetFillStyle, XSetForeground, XSetFunction, 
XSetGraphicsExposures, XSetLineAttributes, XSetPlaneMask, XSetState 
XSetStipple, XSet SubwindowMode, XSetTSOrigin. 
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Name 
XSetFillStyle — set the fill style in a graphics context. 


Synopsis 
XSetFillStyle (display, gc, fill_style) 
Display *display; 
GG” gc; 
int fill_style; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
gc Specifies the graphics context. 


fill_style Specifies the fill style for the specified graphics context. Possible values are 
FillSolid, FillTiled, FillStippled, or FillOpaque- 








Stippled. 
GC foreground Tile 
GC background 
Undrawn Pixels bx] : 
Stipple 
PaaS od we FillTiled FillStippled FillOpaqueStippled 





Description 

XSetFillStyle sets the fil1_stylecomponent of aGC. The fil1_style defines the 
contents of the source for line, text, and fill requests. Fil1S01id indicates that the pixels rep- 
resented by set bits in the source are drawn in the foreground pixel value, and unset bits in 
the source are not drawn. FillTiled uses the tile specified in the GC to determine the 
pixel values for set bits in the source. FillOpaqueStippled specifies that bits set in the 
stipple are drawn in the foreground pixel value and unset bits are drawn in the back- 
ground. FillStippled draws bits set in the source and set in the aupEe in the fore- 
ground color, and leaves unset bits alone. 
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For more information, see Volume One, Chapter 5, The Graphics Context. 


Errors 
BadGC 
BadValue 


Related Commands 
DefaultGC, XChangeGC, XCopyGC, XCreateGC, XFreeGC, XGContextFromGC, 
XSetArcMode, XSetBackground, XSetClipMask, XSetClipOrigin, XSetClip- 
Rectangles, XSetDashes, XSetFillRule, XSetForeground, XSetFunction, 
XSetGraphicsExposures, XSetLineAttributes, XSetPlaneMask, XSetState, 
XSetStipple, XSetSubwindowMode, XSetTSOrigin. 
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— Xlib — Fonts XSetFont 


Name 
XSetFont — set the current font in a graphics context. 
Synopsis 
XSetFont (display, gc, font) 
Display *display; 


Go ge; 
Ponts font); 
Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
gc Specifies the graphics context. 
font Specifies the ID of the font to be used. 
Description 


XSetFont sets the font in the GC. Text drawing requests using this GC will use this font 
only if the font is loaded. Otherwise, the text will not be drawn. 


For more information, see Volume One, Chapter 5, The Graphics Context. 


Errors 
BadFont 
BadGC 


Related Commands 
XCreateFontCursor, XFreeFont, XFreeFontInfo, XFreeFontNames, XFree- 
FontPath, XGetFontPath, XGetFontProperty, XListFonts, XListFontswith- 
Info, XLoadFont, XLoadQueryFont, XQueryFont, XSetFontPath, XUnloadFont. 
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Name 
XSetFontPath — set the font search path. 


Synopsis 
XSetFontPath (display, directories, ndirs) 
Display *display; 
char **directories; 
inbenoErs ; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 


directories Specifies the directory path used to look for the font. Setting the path to the 
empty list restores the default path defined for the X server. 


ndirs Specifies the number of directories in the path. 


Description 
XSetFontPath defines the directory search path for font lookup for all clients. Therefore the 
user should construct a new directory search path carefully by adding to the old directory 
search path obtained by XGet FontPath. Passing an invalid path can result in preventing the 
server from accessing any fonts. Also avoid restoring the default path, since some other client 
may have changed the path on purpose. 


The interpretation of the strings is operating system dependent, but they are intended to specify 


directories to be searched in the order listed. Also, the contents of these strings are operating 
system specific and are not intended to be used by client applications. 


The meaning of errors from this request is system specific. 


Errors 
BadValue 


Related Commands 
xCreateFontCursor, XFreeFont, XFreeFontInfo, XFreeFontNames, XFree- 
FontPath, XGetFontPath, xXGetFontProperty, XListFonts, XListFontswWith- 
Info, XLoadFont, XLoadQueryFont, XQueryFont, XSetFont, XUnloadFont. 
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— Xlib —- Graphics Context —————— XSetFo regrow nd 


Name 
XSetForeground — set the foreground pixel value in a graphics context. 
Synopsis 
XSetForeground (display, gc, foreground) 
Display *display; 
GC’ gc; 
unsigned long foreground; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
gc Specifies the graphics context. 


foreground Specifies the foreground pixel value you want for the specified graphics con- 
text. 


Description 
XSetForeground sets the foreground component in a GC. This pixel value is used for 
set bits in the source according to the £il1_ style. This pixel value must be returned by 
BlackPixel,WhitePixel, ora routine that allocates colors. 


See Volume One, Chapter 5, The Graphics Context, for more information on the GC. 


Errors 
BadGC 


Related Commands 
DefaultGC, XChangeGC, XCopyGC, XCreateGC, XFreeGC, XGContextFromGC, 
XSetArcMode, XSetBackground, XSetClipMask, XSetClipOrigin, XSetClip- 
Rectangles, XSetDashes, XSetFillRule, XSetFillStyle, XSetFunction, 
XSetGraphicsExposures, XSetLineAttributes, XSetPlaneMask, XSetState, 
XSetStipple, XSet SubwindowMode, XSetTSOrigin. 


Xlib Reference Manual : a 443 


XSetFunction Xlib - Graphics Context— 


Name 
XSetFunction — set the bitwise logical operation in a graphics context. 


Synopsis 
XSetFunction (display, gc, function) 
Display *display; 
GEXGC; 
ant function; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 


gc Specifies the graphics context. 


function — Specifies the logical operation you want for the specified graphics context. See 
Description for the choices and their meanings. 


Description 
XSetFunction sets the logical operation applied between the source pixel values (generated 
by the drawing request) and existing destination pixel values (already in the window or pix- 
map) to generate the final destination pixel values in a drawing request (what is actually drawn 
to the window or pixmap). Of course, the plane_mask and clip_mask in the GC also 
affect this operation by preventing drawing to planes and pixels respectively. Gkxcopy, GXin- 
vert, and GxXxor are the only logical operations that are commonly used. 


See Volume One, Chapter 5, The Graphics Context, for more information about the logical 
function. 


The function symbols and their logical definitions are: 





Symbol 

GXclear 0 

GXand src AND dst 
GXandReverse src AND (NOT dst) 
GXcopy src 

GXandInverted (NOT src) AND dst 
GXnoop dst 

GXxor src XOR dst 

GXor src OR dst 

GXnor (NOT src) AND (NOT dst) 
GXequiv (NOT src) XOR dst 
GXinvert (NOT dst) 

GXorReverse src OR (NOT dst) 
GXcopyInverted (NOT src) 
GXorInverted (NOT src) OR dst 
GXnand (NOT src) OR (NOT dst) 
GXset 1 
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Errors 
BadGC ; ‘ 
BadValue 


Related Commands 
DefaultGC, XChangeGC, XCopyGC, XCreateGC, XFreeGC, XGContextFromGc, 
XSetArcMode, XSetBackground, XSetClipMask, XSetClipOrigin, XSetClip- 
Rectangles, XSetDashes, XSetFillRule, XSetFillStyle, XSetForeground, 
XSetGraphicsExposures, XSetLineAttributes, XSetPlaneMask, XSetState, 
XSetStipple, XSet SubwindowMode, XSetTSOrigin. 
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Name 
XSetGraphicsExposures — set the graphics exposures component in a graphics context. 


Synopsis 
XSetGraphicsExposures (display, gc, graphics_exposures) 
Display *display; 
GC gc; 
Bool graphics _exposures; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 


gc Specifies the graphics context. 


graphics _exposures 
Specifies whether you want GraphicsExpose and NoExpose events when 
calling XCopyArea and XCopyP1lane with this graphics context. 


Description 
XSetGraphicsExposure sets the graphics_exposures member of a GC. If 
graphics exposures is True, GraphicsExpose events will be generated when. 
XCopyArea and XCopyPlane requests cannot be completely satisfied because a source 
region is obscured, and NoExpose events are generated when they can be completely satis- 
fied. If graphics_exposures is False, these events are not generated. 


These events are not selected in the normal way with xSelectInput. Setting the 
graphics exposures member of the GC used in the CopyArea or CopyP lane request 
is the only way to select these events. 


For more information, see Volume One, Chapter 5, The Graphics Context. 


Errors 
BadGC 
BadValue 


Related Commands 
DefaultGC, XChangeGC, XCopyGC, XCreateGC, XFreeGC, XGContextFromGC, 
XSetArcMode, XSetBackground, XSetClipMask, XSetClipOrigin, XSetClip- 
Rectangles, XSetDashes, XSetFillRule, XSetFillStyle, XSetForeground, 
XSetFunction, XSetLineAttributes, XSetPlaneMask, XSetState, XSet- 
Stipple, XSet SubwindowMode, XSetTSOrigin. 
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Name 
XSetIconName — set the name to be displayed in a window’s icon. 


Synopsis 
XSetIconName (display, w, icon_name) 
Display *display; 
Window w; 
char *icon_name; 


Arguments 


display Specifies a connection to an X server; returned from XOpenDisplay. 
w Specifies the ID of the window whose icon name is being set. 


icon_name _ Specifies the name to be displayed in the window’s icon. The name should be 
a null-terminated string. This name is returned by any subsequent call to 
XGetIconName. 


Description 
XSetIconName is superseded by XSetWMIconName in Release 4. 


XSetIconName sets the XA_WM_ICON_NAME property for a window. This is usually set by an 
application for the window manager. The name should be short, since it is to be displayed in 
association with an icon. 


XSetStandardProperties (in Release 4) or XSetWMProperties (in Release 4) also 
set this property. 


For more information, see Volume One, Chapter 10, /nterclient Communication. 


Errors 
BadAlloc 
BadWindow 


Related Commands 
XFetchName, XGetClassHint, XGetIconName, XGetIconSizes, XGetNormal- 
Hints, XGetSizeHints, XGetTransientForHint, XGetWMHints, XGet Zoom- 
Hints, XSetClassHint, XSetCommand, XSetIconSizes, XSetNormalHints, 
XSetSizeHints, XSetTransientForHint, XSetWMHints, XSetZoomHints, 
XStoreName. 
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Name 
XSetIconSizes — set the value of the XA_WM_ICON_SIZE property. 


Synopsis 
XSetIconSizes (display, w, size_list, count) 
Display *display; 
Window w; 
XIconSize *size_list; 
int count; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
w Specifies the ID of the window whose icon size property is to be set. Nor- 


mally the root window. 
Sizerlist Specifies a pointer to the size list. 
count Specifies the number of items in the size list. 


Description 
XSetIconSizes is normally used by a window manager to set the range of preferred icon 
sizes in the XA_WM_ICON_SIZE property of the root window. 


Applications can then read the property with XGet IconSizes. 


Structures 
typedef struct { 
int min width, min height; 
int max_width, max_height; 
int: width inc, height. inc; 
} XIconSize; 


Errors 
BadAlloc 
BadWindow 


Related Commands 
XAllocIconSize, XFetchName, XGetClassHint, XGetIconName, XGetIcon- 
Sizes, XGetNormalHints, XGetSizeHints, XGetTransientForHint, XGet- 
WMHints, XGet ZoomHints, XSetClassHint, XSetCommand, XSetIconName, 
XSetNormalHints, XSetSizeHints, XSetTransientForHint, XSetWMHints, 
XSetZoomHints, XStoreName. 
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Name 
XSetInputFocus — set the keyboard focus window. 
Synopsis i 
XSetInputFocus (display, focus, revert_to, time) 
Display *display; 
Window focus; 
int revert_to; 
Time time; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 


focus Specifies the ID of the window you want to be the keyboard focus. Pass the 
window ID, PointerRoot, or None. 


revert to Specifies which window the keyboard focus reverts to if the focus window 
becomes not viewable. Pass one of these constants: RevertToParent, 
RevertToPointerRoot, or RevertToNone. Must not be a window ID. 


time _ Specifies the time when the focus change should take place. Pass either a 
timestamp, expressed in milliseconds, or the constant CurrentTime. Also 
returns the time of the focus change when Current Time is specified. 


Description 
XSetInputFocus changes the keyboard focus and the last-focus-change time. The function 
has no effect if time is earlier than the current last-focus-change time or later than the current 
X server time. Otherwise, the last-focus-change time is set to the specified time, with 
CurrentTime replaced by the current X server time. 


XSetInputFocus generates FocusIn and FocusOut events if focus is different from 
the current focus. 


XSetInputFocus executes as follows, depending on what value you assign to the focus 
argument: 


° If you assign None, all keyboard events are discarded until you set a new focus window. 
In this case, revert_to is ignored. 


3 If you assign a window ID, it becomes the main keyboard’s focus window. Ifa generated 
keyboard event would normally be reported to this window or one of its inferiors, the 
event is reported normally; otherwise, the event is reported to the focus window. The 
specified focus window must be viewable at the time of the request (else a BadMatch 
error). If the focus window later becomes not viewable, the focus window will change to 
the revert_to argument. 


° If you assign PointerRoot, the focus window is dynamically taken to be the root win- 
dow of whatever screen the pointer is on at each keyboard event. In this case, 
revert _toisignored. This is the default keybcard focus setting. 


If the focus window later becomes not viewable, XSetInputFocus evaluates the 
revert_to argument to determine the new focus window: 
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° If you assign Revert ToParent, the focus reverts to the parent (or the closest viewable 
ancestor) automatically with anew revert_to argument of Revert ToName. 


° If you assign Revert ToPointerRoot or RevertToNone, the focus reverts to that 
value automatically. FocusIn and FocusOut events are generated when the focus 
reverts, but the last focus change time is not affected. 


Errors 
BadMatch focus window not viewable when XSet InputFocus called. 


BadValue 
BadWindow 


Related Commands 
QLength, XAllowEvents, XCheckIfEvent, XCheckMaskEvent, XCheckTyped- 
Event, XCheckTypedWindowEvent, XCheckWindowEvent, XEventsQueued, 
XGet Input Focus, XGetMotionEvents, XIfEvent, XMaskEvent, XNextEvent, 
XPeekEvent, XPeekIfEvent, XPending, XPutBackEvent, XSelectInput, 
XSendEvent, XSynchronize, XWindowEvent. 
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Name 
XSetErrorHandler — set a nonfatal error event handler. 


Synopsis 
In Release 3: 
XSetIOErrorHandler (handler) 
int (* handler) (Display *, XErrorEvent *) 
In Release 4: 
int (*XSetIOErrorHandler (handler) ) () 
int (* handler) (Display *, XErrorEvent *) 


Arguments 
handler Specifies user-defined fatal error handling routine. If NULL, reinvoke the 
default fatal error handler. 
Description 


XSetIOErrorHandler specifies a user-defined error handling routine for fatal errors. This 

~ error handler will be called by Xlib if any sort of system call error occurs, such as the connec- 
tion to the server being lost. The called routine should not return. If the I/O error handler does 
return, the client process will exit. 


If handler is a NULL pointer, the default error handler is reinstated. The default I/O error 
handler prints an error message and exits. 


In Release 4, XSet IOErrorHandler returns a pointer to the previous error handler. 
For more information, see Volume One, Chapter 3, Basic Window Program. 
Related Commands 


XDisplayName, XGetErrorDatabaseText, XGetErrorText, XSetAfter- 
Function, XSetErrorHandler, XSynchronize. 
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Name 
XSetLineAttributes — set the line drawing components in a graphics context. 


Synopsis 
XSetLineAttributes (display, gc, line_width, line_style, 
cap style, join_style) 
Display *display; 
Geygc; 
unsigned int line _width; 
int’? tine style; 
int cap style; 
int join style; 








Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
gc Specifies the graphics context. 
eee LineSolid LineOnoOffDash LineDoubleDash 
cap_style 
CapNotLast CapButt CapRound CapProjecting 











join_style 





JoinRound JoinMiter 


JoinBevel 











£ill_style 
Tile GC foreground GC background Undrawn Pixels [x] 





FillSolid FillTiled FillStippled FillOpaqueStippled 


Stipple 
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line width Specifies the line width in the specified graphics context. 


line_style Specifies the line style in the specified graphics context. Possible values are 
LineSolid, LineOnOffDash, or LineDoubleDash. 


cap_style Specifies the line and cap style in the specified graphics context. Possible 
values are CapNot Last, CapButt, CapRound, or CapProjecting. 


join_style Specifies the line-join style in the specified graphics context. Possible values 
are JoinMiter, JoinRound, or JoinBevel. If you specify Join- 
Mitre, JoinBevel is used instead if the angle separating the two lines is 
less than 11 degrees. 


Description 
XSetLineAttributes sets four types of line characteristics in the GC: line width, 
line_style,cap_style,and join_style. 


See the description of line and join styles in Volume One, Chapter 5, The Graphics Context. 
_ See also XSetDashes. 


A line_width of zero (0) means to use the fastest algorithm for drawing a line of one pixel 
width. These lines may not meet properly with lines specified as width one or more. 


Errors 
BadGC 
BadValue 


Related Commands 
DefaultGC, XChangeGC, XCopyGC, XCreateGC, XFreeGC, XGContextFromGC, 
XSetArcMode, XSet Background, XSetClipMask, XSetClipOrigin, XSetClip- 
Rectangles, XSetDashes, XSetFillRule, xXSetFillStyle, XSetForeground, 
XSetFunction, XSetGraphicsExposures, XSetPlaneMask, XSetState, XSet- 
Stipple, XSet SubwindowMode, XSetTSOrigin. 
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Name 


XSetModifierMapping — set keycodes to be used as modifiers (Shift, Control, etc.). 


Synopsis 


int XSetModifierMapping(display, mod_map) 
Display *display; 
XModifierKeymap *mod_map; 


Arguments 


display Specifies a connection to an X server; returned from XOpenDisplay. 


mod_map Specifies the XModifierKeymap structure containing the desired modifier 
key codes. 


Description 


454 


XSetModifierMapping is one of two ways to specify the keycodes of the keys that are to 
be used as modifiers (like Shift, Control, etc.). XSetModifierMapping specifies all the 
keycodes for all the modifiers at once. The other, easier, way is to use XInsert- 
ModifiermapEntry and XDeleteModifiermapEntry, which add or delete a single 
keycode for a single modifier key. XSetModifierMapping does the work in a single call, 
but the price of this call is that you need to manually set up the X€ModifierKeymap structure 
pointed to by mod_map. This requires you to know how the XModifierKeymap structure is 
defined and organized, as described in the next three paragraphs. 


The XModifierKeymap structure for the mod_map argument should be created using 
XNewModifierMap or XGetModifierMapping. The Max_keypermod element of the 
structure specifies the maximum number of keycodes that can be mapped to each modifier. You 
define this number but there may be an upper limit on a particular server. 


The modifiermap element of the structure is an array of keycodes. There are eight by 
max_keypermod keycodes in this array: eight because there are eight modifiers, and 
max_keypermod because that is the number of keycodes that must be reserved for each mod- 
ifier. 


The eight modifiers are represented by the constants ShiftMapIndex, LockMapIndex, 
ControlMapIndex, Mod1lMapIndex, Mod2MapIndex, Mod3MapIndex, Mod4Map- 
Index, and Mod5MapIndex. These are not actually used as arguments, but they are conve- 
nient for referring to each row in the modifiermap structure while filling it. The definitions 
of these constants are shown in the Structures section below. 


Now you can interpret the modifiermap array. For each modifier in a given modifier- 
map, the keycodes which correspond are from modifiermap[index * 
max_keypermod] to modifiermap[((index + 1) * max_keyspermod) -1] 
where index is the appropriate modifier index definition (ShiftMapIndex, LockMap- 
Index, etc.). You must set the mod_map array up properly before calling XSetModifier- 
Mapping. Now you know why XInsertModifierMapEntry and XDeleteModifier- 
MapEnt ry were created! 


Zero keycodes are ignored. No keycode may appear twice anywhere in the map (otherwise, a 
BadValue error is generated). In addition, all of the nonzero keycodes must be in the range 
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specified by min_keycode and max_keycode in the Display structure (otherwise a 
BadValue error occurs). 


A server can impose restrictions on how modifiers can be changed. For example, certain keys 
may not generate up transitions in hardware, certain keys may always auto-repeat and therefore 
be unsuitable for use as modifiers, or multiple modifier keys may not be supported. If a restric- 
tion is violated, then the status reply is MappingFailed, and none of the modifiers are 
changed. 


XSetModifierMapping returns MappingSuccess or MappingBusy. The server gen- 

' erates aMappingNotify event on a MappingSuccess status. If the new keycodes speci- 
fied for a modifier differ from those currently defined and any (current or new) keys for that 
modifier are in the down state, then the status reply is MappingBusy, and none of the modifi- 
ers are changed. 


A value of zero for modi fiermap indicates that no keys are valid as any modifier. 


Structures 
typedef struct { 
int max_keypermod; /* server's max # of keys per modifier */ 
KeyCode *modifiermap; /* an 8 by max keypermod array */ 
} XModifierKeymap; 


/* Modifier name symbols. Used to build a SetModifierMapping request or 
to read a GetModifierMapping request. */ 

#define ShiftMapIndex 0 

#define LockMapIndex 
#define ControlMapIndex 
#define Mod1MapIndex 
#define Mod2MapIndex 
#define Mod3MapIndex 
#define Mod4MapIndex 
#define Mod5MapIndex 


YD OBWNP 


Errors 
BadGAlloc 


BadValue Keycode appears twice in the map. 
Keycode < display->min_keycode or 
keycode > display->max_keycode. 


Related Commands 
XChangeKeyboardMapping, XDeleteModifiermapEntry, XDelete- 
ModifiermapEnt ry, XFreeModifiermap, XGetKeyboardMapping, XGet- 
ModifierMapping, XInsertModifiermapEntry, XInsertModifiermapEntry, 
XKeycodeToKeysym, XKeysymToKeycode, XKeysymToString, XLookupKeysym, 
XLookupSt ring, XNewModifierMap, XQueryKeymap, XRebindKeysym, 
XRefreshKeyboardMapping, XStringToKeysym. 
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Name 
XSetNormalHints — set the size hints property of a window in normal state (not zoomed or 
iconified). 
Synopsis 


void XSetNormalHints (display, w, hints) 
Display *display; 
Window w; 
XSizeHints *hints; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
w Specifies the window ID. 
hints Specifies a pointer to the sizing hints for the window in its normal state. 
Description 


XSetNormalHints has been superseded by XSetWMNormalHints as of Release 4. 


XSetNormalHints sets the XA_WM NORMAL HINTS property for the specified window. 
Applications use XSetNormalHints to inform the window manager of the size or position 
desirable for that window. In addition, an application wanting to move or resize itself should 
call XSetNormalHints specifying its new desired location and size, in addition to making 
direct X calls to move or resize. This is because some window managers may redirect window 
configuration requests, but ignore the resulting events and pay attention to property changes 
instead. 


To set size hints, an application must assign values to the appropriate elements in the hints 
structure, and also set the flags field of the structure to indicate which members have 
assigned values and the source of the assignment. These flags are listed in the Structures sec- 
tion below. 


For more information on using hints, see Volume One, Chapter 10, /nterclient Communication. 


Structures 
typedef struct { 

long flags; /* which fields in structure are defined */ 
aT FY 4p 
int width, height; 
int min_width, min_height; 
int max width, max_height; 
int width_inc, height_inc; 


Struct. { 
denitce scp /* numerator */ 
een temny ie /* denominator */ 
} min_aspect, max_aspect; 
} XSizeHints; /* new fields in R4 here */ 
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<< 
<< 


0) 
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2) 
3) 
4) 
5) 
6) 
7) 


/* 
/* 


/* 
/* 
/* 
/* 
/* 
/* 


(continued) 


XSetNormalHints 


user specified x, y */ 
user specified width, height */ 


program 
program 
program 
program 
program 
program 


specified 
specified 
specified 
specified 
specified 
specified 


position */ 

size */ 

minimum size */ 

maximum size */ 

resize increments */ 
min/max aspect ratios */ 


PAll]lHints (PPosition|PSize|PMinSize|PMaxSize|PResizelInc|PAspect) 


#define USPosition (1L 
#define USSize (1L 
#define PPosition (1L 
#define PSize (as 
#define PMinSize (1L 
#define PMaxSize (1L 
#define PResizelInc (1L 
#define PAspect (1L 
#define 

Errors 
BadAlloc 
BadWindow 


Related Commands 
XFetchName, XGetClassHint, XGetIconName, XGetIconSizes, XGetNormal- 

_ Hints, XGetSizeHints, XGetTransientForHint, XGetWMHints, XGet Zoom- 
Hints, XSetClassHint, XSetCommand, XSetIconName, XSetIconSizes, XSet- 
SizeHints, XSetTransientForHint, XSetWMHints, XSetZoomHints, XStore- 


Name. 
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XSetPlaneMask Xlib — Graphics Context— 


Name 
XSetPlaneMask — set the plane mask in a graphics context. 


Synopsis 
XSetPlaneMask (display, gc, plane_mask) 
Display *display; 
Ge" gc; 
unsigned long plane_mask; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
gc Specifies the graphics context. 


Plane_mask Specifies the plane mask. You can use the macro Al1Planes if desired. 


Description 
XSetPlaneMask sets the plane_mask component of the specified GC. The plane_mask 
determines which planes of the destination drawable are affected by a graphics request. 


For more information, see Volume One, Chapter 5, The Graphics Context. 


Errors 
BadGC 


Related Commands 
DefaultGC, XChangeGC, XCopyGC, XCreateGC, XFreeGC, XGContextFromGC, 
XSetArcMode, XSetBackground, XSetClipMask, XSetClipOrigin, XSetClip- 
Rectangles, XSetDashes, XSetFillRule, XSetFillStyle, XSetForeground, 
XSetFunction, XSetGraphicsExposures, XSetLineAttributes, XSetState, 
XSetStipple, XSet SubwindowMode, XSetTSOrigin. 
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Name 
XSetPointerMapping — set the pointer button mapping. 


Synopsis 
int XSetPointerMapping (display, map, nmap) 
Display *display; 
unsigned char map[]; 


int nmap; 
Arguments : 
display Specifies a connection to an X server; returned from XOpenDisplay. 
map Specifies the mapping list. 
nmap Specifies the number of items in the mapping list. 
Description 


XSetPointerMapping sets the mapping of the pointer buttons. Elements of the map list 
are indexed starting from 1. The length of the list nmap must be the same as KGet Pointer- 
Mapping returns (you must call that first). The index is a physical button number, and the ele- 
ment of the list defines the effective button number. In other words, if map[2] is set to 1, 
when the second physical button is pressed, a ButtonPress event will be generated if But - 
ton1Mask was selected but not if Button2Mask was selected. The button member in the 
event will read Button. 


No two elements can have the same nonzero value (else a BadValue error). A value of zero 
for an element of map disables a button, and values for elements are not restricted in value by 
the number of physical buttons. If any of the buttons to be altered are currently in the down 
state, the returned value is MappingBusy and the mapping is not changed. 


This function returns either MappingSuccess or MappingBusy. XSetPointer- 
Mapping generates aMappingNotify event when it returns MappingSuccess. 


Errors 
BadValue Two elements of map[] have same nonzero value. 


nmap not equal to XGet PointerMapping return value. 


Related Commands 
XChangeActivePointerGrab, XChangePointerControl, XGetPointer- 
Control, XGetPointerMapping, XGrabPointer, XQueryPointer, XUngrab- 
Pointer, XWarpPointer, 
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Name 
XSetRGBColormaps — set an XStandardColormap structure. 


Synopsis 
void XSetRGBColormaps (display, w, std_colormap, count, prop- 

erty) 

Display *display; 

Window w; 

XStandardColormap *std_colormap; 

int..count; 

Atom property; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
w Specifies the window. 


std_colormap 
Specifies the XSt andardColormap structure to be used. 


count Specifies the number of colormaps. 


property Specifies the property name. 


Availability 
Release 4 and later. 


Description 
XSetRGBColormaps replaces the RGB colormap definition in the specified property on the 
named window. If the property does not already exist, XSet RGBColormaps sets the RGB 
colormap definition in the specified property on the named window. The property is stored with 
a type of RGB_COLOR_MAP and a format of 32. Note that it is the caller’s responsibility to honor 
the ICCCM restriction that only RGB_DEFAULT MAP contain more than one definition. 


XSetRGBColormaps supersedes XSet StandardColormap. 


For more information, see Volume One, Chapter 7, Color. 


Structures 
typedef struct { 

Colormap colormap; 
unsigned long red _ max; 
unsigned long red mult; 
unsigned long green max; 
unsigned long green mult; 
unsigned long blue max; 
unsigned long blue mult; 
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unsigned long base pixel; 

VisualID visualid; ‘/* added by ICCCM version 1 */ 

KID) Kids /* added by ICCCM version 1 */ 
} XStandardColormap; 


Errors 
BadAlloc 
BadAtom 
BadWindow 


Related Commands 
XAllocStandardColormap, XGetRGBColormaps, XVisualIDFromVisual. 
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Name 
XSetRegion — set clip mask of the graphics context to the specified region. 


Synopsis 
XSetRegion (display, gc, Ir) 
Display *display; 
GC. gc 
Region r; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
ge Specifies the graphics context. 
z Specifies the region. 

Description 


XSetRegion sets the clip mask component of a GC to the specified region. Thereafter, all 
drawing made with gc will be confined to the the area of intersection of the region and the 
drawable. 


Regions are located using an offset from a point (the region origin) which is common to all 
regions. It is up to the application to interpret the location of the region relative to a drawable. 
When the region is to be used as aclip_mask by calling XSet Region, the upper-left corner 
of region relative to the drawable used in the graphics request will be at (xoffset + 
clip_x origin, yoffset + clip_y origin), where xoffset and yoffset are 
the offset of the region and clip _x origin andclip y origin are elements of the GC 
used in the graphics request. 


For more information on regions, see Volume One, Chapter 5, The Graphics Context, and 
Chapter 6, Drawing Graphics and Text. 


Structures 
Region is a pointer to an opaque structure type. 


Related Commands 
XClipBox, XCreateRegion, XDest royRegion, XEmptyRegion, XEqualRegion, 
XIntersectRegion, XOffsetRegion, XPointInRegion, XPolygonRegion, 
XRect InRegion, XShrinkRegion, XSubt ractRegion, XUnionRectWithRegion, 
XUnionRegion, XXorRegion. 
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Name 
XSetScreenSaver — set the parameters of the screen saver. 


Synopsis 
XSetScreenSaver (display, timeout, interval, 
prefer blanking, allow_exposures) 
Display *display; 
int timeout, interval; 
int prefer blanking; 
int allow_exposures; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
timeout Specifies the time of inactivity, in seconds, before the screen saver turns on. 
interval Specifies the interval, in seconds, between screen saver invocations. This is 


for intermittent changes to the display, not blanking. 


prefer blanking 
Specifies whether to enable screen blanking. Possible values are Dont- 
PreferBlanking, PreferBlanking, or DefaultBlanking. 


allow_exposures 
Specifies the current screen saver control values. Possible values are Dont- 
AllowExposures, AllowExposures, or DefaultExposures. 


Description 
XSetScreenSaver sets the parameters that control the screen saver. timeout and 
interval are specified in seconds. A positive timeout enables the screen saver. A 
timeout of zero (0) disables the screen saver, while a timeout of —1-restores the default. An 
interval of zero (0) disables the random pattern motion. If no input from devices (key- 
board, mouse, etc.) is generated for the specified number of timeout seconds, the screen saver is 
activated. 


For each screen, if blanking is preferred and the hardware supports video blanking, the screen 
will simply go blank. Otherwise, if either exposures are allowed or the screen can be regen- 
erated without sending exposure events to clients, the screen is tiled with the root window 
background tile, with a random origin, each interval seconds. Otherwise, the state of the 
screen does not change. All screen states are restored at the next input from a device. 


If the server-dependent screen saver method supports periodic change, interval serves as a 
hint about how long the change period should be, and a value of zero (0) hints that no periodic 
change should be made. Examples of ways to change the screen include scrambling the color 
map periodically, moving an icon image about the screen periodically, or tiling the screen with 
the root window background tile, randomly reoriginated periodically. 


For more information on the screen saver, see Volume One, Chapter 13, Other Programming 
Techniques. 
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Errors 
BadValue timeout <-l. 


Related Commands 
XActivateScreenSaver, XForceScreenSaver, XGetScreenSaver, XReset- 
ScreenSaver. 
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Name 
XSetSelectionOwner — set the owner of a selection., 


Synopsis 
XSetSelectionOwner (display, selection, owner, time) 
Display *display; 
Atom selection; 
Window owner; 
Time time; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 


selection Specifies the selection atom. Predefined atoms are XA_PRIMARY and 
XA_SECONDARY. 


owner Specifies the desired owner of the specified selection atom. This value is 
either a window ID or None. 


time ' Specifies the time when the grab should take place. Pass either a timestamp, 
expressed in milliseconds, or the constant Current Time. 


Description 

XSetSelectionOwner sets the owner and last-change time of a selection property. This 
should be called by an application that supports cutting and pasting between windows (or at 
least cutting), when the user has made a selection of any kind of text, graphics, or data. This 
makes the information available so that other applications can request the data from the new 
selection owner using XConvertSelection, which generates a SelectionRequest 
event specifying the desired type and format of the data. Then the selection owner sends a 
SelectionNotify using XSendEvent, which notes that the information is stored in the 
selection property in the desired format or indicates that it couldn’t do the conversion to the 
desired type. 


If owner is specified as None, then this client is giving up ownership voluntarily. Otherwise, 
the new owner is the client executing the request. 


If the new owner is not the same as the current owner of the selection, and the current owner is 
a window, then the current owner is senta SelectionClear event. This indicates to the old 
owner that the selection should be unhighlighted. 


If the selection owner window is later destroyed, the owner of the selection automatically 
reverts to None. 


The value you pass to the time argument must be no earlier than the last-change time of the 
specified selection, and no later than the current time, or the selection is not affected. The new 
last-change time recorded is the specified time, with CurrentTime replaced by the current 
server time. If the X server reverts a selection owner to None, the last-change time is not 
affected. 


For more information on selections, see Volume One, Chapter 10, Interclient Communication. 
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Errors 
BadAtom 
BadWindow 


Related Commands 
XConvertSelection, XGetSelectionOwner. 
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— Xlib — Window Manager Hints XSetSizeHints 


Name 
XSetSizeHints — set the value of any property of type XA_SIZE_HINTS. 


Synopsis 
XSetSizeHints (display, w, hints, property) 
Display *display; 
Window w; 
XSizeHints *hints; 
Atom property; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
w Specifies the window ID. 
hints Specifies a pointer to the size hints. 


property Specifies the property atom. 


Description 
XSetSizeHints has been superseded by XSetWMSizeHints as of Release 4. 


XSetSizeHints sets the named property on the specified window to the specified xSize- 
Hints structure. This routine is useful if new properties of type XA_WM SIZE_HINTS are 
defined. The predefined properties of that type have their own set and get functions, XSet- 
NormalHints and XSetZoomHints (XSetWMHints in Release 4—zoom hints are obso- 
lete). 


The flags member of XSizeHints must be set to the OR of the symbols representing each 
member to be set. 


For more information on using hints, see Volume One, Chapter 10, Interclient Communication. 


Structures 
typedef struct { 

long flags; /* which fields in structure are defined */ 
NEE eG 
int width, height; 
int min_width, min_height; 
int max_width, max_height; 
int width_inc, height_inc; 


SELUCEAM 
Pat tee /* numerator */ 
int y; /* denominator */ 


} min_aspect, max_aspect; 
} XSizeHints; 


/* flags argument in size hints */ 
#define USPosition (1L << 0) /* user specified x, y */ 


#define USSize (1L°<< 1) /* user specified width, height. */ 
#define PPosition (1L << 2) /* program specified position */ 
#define PSize (1L << 3) /* program spécified size */ 
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#define PMinSize (1L << 4) /* program specified minimum size */ 

#define PMaxSize (1L << 5) /* program specified maximum size */ 

#define PResizeInc (1L << 6) /* program specified resize increments */ 
#define PAspect (1L << 7) /* program specified min/max aspect ratios */ 


#define PAllHints (PPosition|PSize|PMinSize|PMaxSize|PResizeInc|PAspect) 


Errors 


BadAlloc 
BadAtom 
BadWindow 


Related Commands 
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XFetchName, XGetClassHint, XGetIconName, XGetIconSizes, XGetNormal- 
Hints, XGetSizeHints, XGetTransientForHint, XGetWMHints, XGet Zoom- 
Hints, XSetClassHint, XSetCommand, XSetIconName, XSetIconSizes, XSet- 
NormalHints, XSetTransientForHint, XSetWMHints, XSetZoomHints, 
XStoreName. 
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2116 2 Coteritidps XSetStandardColormap 


Name 


XSetStandardColormap — change the standard colormap property. 


Synopsis 


void XSetStandardColormap(display, w, cmap_info, property) 
Display *display; 
Window w; 
XStandardColormap *cmap_ info; 


Atom 


Arguments 
display 


Ww 


property; 


Specifies a connection to an X server; returned from XOpenDisplay. 


Specifies the ID of the window with which this colormap will be associated. 


cmap info Specifies the filled colormap information structure. 


property 


Description 


Specifies the standard colormap property to set. The predefined standard color- 
maps are: XA_RGB BEST MAP, XA_RGB RED MAP, XA_RGB GREEN _ MAP, 
XA_RGB BLUE MAP, XA RGB DEFAULT MAP, and XA_RGB_ GRAY MAP. 


XSetStandardColormap has been superseded by XSet RGBColormap as of Release 4. 


XSetStandardColormap defines a standard colormap property. To create a standard color- 


map, follow 


1. Open 


this procedure: 


a new connection to the same server. 


2). Grab the server. 


3.  Seeif property is on the property list of the root window for the display, using xGet - 
StandardColormap. If so, see if the colormap field is nonzero. If it is, the color- 
map already exists. 


4, — If the desired property is not present, do the following: 


Determine the color capabilities of the display. Choose a visual. 
Create a colormap (not required for XA_RGB_DEFAULT_ MAP). 


Call XAllocColorPlanes or XAllocColorCells to allocate cells in the 
colormap. 


Call XStoreColors to store appropriate color values in the colormap. 
Fill in the descriptive fields in the structure. 

Call XxSet StandardColormap to set the property on the root window. 
Use XSetCloseDownMode to make the resource permanent. 


Close the new connection to the server. 
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5.  Ungrab the server. 
6. Close the new connection to the server. 


See description of standard colormaps in Volume One, Chapter 7, Color. 


Errors 
BadAlloc 
BadAtom 
BadWindow 
Structures 
typedef struct { 
Colormap colormap; /* ID of colormap made by XCreateColormap */ 
unsigned long red_max; 
unsigned long red _ mult; 
unsigned long green _ max; 
unsigned long green mult; 
unsigned long blue _max; 
unsigned long blue mult; 
unsigned long base pixel; 
} XStandardColormap; /* new fields in R4 */ 


Related Commands 
DefaultColormap, DisplayCells, XCopyColormapAndF ree, XCreate- 
Colormap, XFreeColormap, XGetStandardColormap, XInstallColormap, 
XListInstalledColormaps, XSetWindowColormap, XUninstallColormap. 
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—Xilb — Properties J XSetStandardProperties 


Name 
XSetStandardProperties — set the minimum set of properties for the window manager. 


Synopsis 
XSetStandardProperties (display, w, window_name, icon_name, 
icon_pixmap, argv, argc, hints) 
Display *display; 
Window w; 
char *window_name; 
char *icon_name; 
Pixmap icon_pixmap; 
char **argv; 
int argc; 
XSizeHints *hints 


Arguments 
_ display Specifies a connection to an X server; returned from XOpenDisplay. 
w Specifies the window ID. 


window name Specifies the name of the window. 
icon_name Specifies the name to be displayed in the window’s icon. 


icon_pixmap Specifies the pixmap that is to be used for the icon, or None. This pixmap 
must be of depth 1. 


argv Specifies a pointer to the command and arguments used to start the applica- 
tion. 
argc Specifies the number of arguments. 
hints Specifies a pointer to the size hints for the window in its normal state. 
Description 


XSetStandardProperties is superceded by XSet WMP roperties in Release 4. 


XSetStandardProperties sets in a single call the most essential properties for a quickie 
application. XSet StandardProperties gives a window manager some information about 
your program’s preferences; it probably will not be sufficient for complex programs. 


See Volume One, Chapter 10, Interclient Communication for a description of standard proper- 
ties. 


Structures 
typedef struct { 

long flags; /* which fields in structure are defined */ 
int x, 0¥7 
int width, height; 
int min_width, min_height; 
int max_width, max_height; 
int width_inc, height_inc; 
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struct { 
sree /* numerator */ 
EINEM Ys /* denominator */ 
} min_aspect, max_aspect; 
} XSizeHints; 


(continued) 


Xlib — Properties 


/* new fields in R4 */ 


/* flags argument in size hints */ 
user specified x, y */ 
user specified width, height */ 


<< 
<< 


<< 
<< 
<< 
<< 
<< 
<< 


ON as 
Nes 


ZX 
See 
ges 
ex 
Gye 
LE 


program 
program 
program 
program 
program 
program 


specified 
specified 
specified 
specified 
specified 
specified 


position */ 

size */ 

minimum size */ 

maximum size */ 

resize increments */ 

min and max aspect ratios */ 


PAll1Hints (PPosition|PSize|PMinSize|PMaxSize|PResizeInc|PAspect) 


#define USPosition (1L 
#define USSize (GING 
#define PPosition (ls 
#define PSize (a 
#define PMinSize (late 
#define PMaxSize (1L 
#define PResizeInc (1L 
#define PAspect (1E 
#define 

Errors 
BadAlloc 
BadWindow 


Related Commands 
XChangeProperty, XDeleteProperty, XGetAtomName, XGetFontProperty, 
XGetWindowProperty, XInternAtom, XListProperties, XRotateWindow- 
Properties. 
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Name ; 
XSetState — set the foreground, background, logical function, and plane mask in a graphics 
context. 
Synopsis 


XSetState (display, gc, foreground, background, function, 
plane_mask) 
Display *display; 
SCmoOe. 
unsigned long foreground, background; 
int Function F 
unsigned long plane_mask; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
gc Specifies the graphics context. 


foreground Specifies the foreground for the specified graphics context. 
background Specifies the background for the specified graphics context. 
function | Specifies the logical function for the specified graphics context. 


plane_mask Specifies the plane mask for the specified graphics context. 


Description 
XSetState sets the foreground and background pixel values, the logical function, 
and the plane_mask in a GC. See XSetForeground, XSetBackground, XSet- 
Function, and XSetP1laneMask for what these members do and appropriate values. 


See Volume One, Chapter 5, The Graphics Context, for more information. 


Errors 
BadGC 
BadValue 


Related Commands 
DefaultGC, XChangeGC, XCopyGC, XCreateGC, XFreeGC, XGContextFromGC, 
XSetArcMode, XSetBackground, XSetClipMask, XSetClipOrigin, XSetClip- 
Rectangles, XSetDashes, XSetFillRule, XSetFillStyle, XSetForeground, 
XSetFunction, XSetGraphicsExposures, XSetLineAttributes, XSetPlane- 
Mask, XSetStipple, XSet SubwindowMode, XSetTSOrigin. 


Xlib Reference Manual ; 473 


XSetStipple Xlib — Graphics Context— 


Name 
XSetStipple — set the stipple in a graphics context. 


Synopsis 
XSetStipple (display, gc, stipple) 
Display *display; 
(Gemciany 
Pixmap stipple; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 


gc Specifies the graphics context. 


stipple Specifies the stipple for the specified graphics context. 


Description 
XSetStipple sets the stipple component of a GC. The stipple is a pixmap of depth 
one. It is laid out like a tile. Set bits in the stipple determine which pixels in an area are drawn 
in the foreground pixel value. Unset bits in the stipple determine which pixels are drawn in 
the background pixel value if the fill style is FillOpaqueStippled. If 
fill _style is FillStippled, pixels overlayed with unset bits in the stipple are not 
drawn. If £il1_ style is FillTiledor FillSo1id, the stipple is not used. 


For more information, see Volume One, Chapter 5, The Graphics Context. 


Errors 
BadGC 
BadMatch 
BadPixmap 


Related Commands 
DefaultGC, XChangeGC, XCopyGC, XCreateGC, XFreeGC, XGContextFromGC, 
XSetArcMode, XSetBackground, XSetClipMask, XSetClipOrigin, XSetClip- 
Rectangles, XSetDashes, XSetFillRule, XSetFillStyle, xSetForeground, 
XSetFunction, XSetGraphicsExposures, XSetLineAttributes, XSetPlane- 
Mask, XSetState, XSet SubwindowMode, XSetTSOrigin. 
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Name é 
XSetSubwindowMode — set the subwindow mode in a graphics context. 
Synopsis 
XSetSubwindowMode (display, gc, subwindow_mode) 
Display *display; 
GSE igicy; 
int subwindow_mode; 


Arguments - 
display Specifies a connection to an X server; returned from XOpenDisplay. 
gc Specifies the graphics context. 


subwindow_mode 
_ Specifies the subwindow mode you want to set for the specified graphics con- 
text. Possible values are ClLipByChildren or IncludeInferiors. 


Description 
XSetSubwindowMode sets the subwindow_mode component of a GC. Clip- 
ByChildren means that graphics requests will be clipped by all viewable children. 
IncludeInferiors means draw through all subwindows. 


For more information, see Volume One, Chapter 5, The Graphics Context. 


Errors 
BadGC 
BadValue 


Related Commands 
DefaultGC, XChangeGC, XCopyGC, XCreateGC, XFreeGC, XGContextFromGC, 
XSetArcMode, XSetBackground, XSetClipMask, XSetClipOrigin, XSetClip- 
Rectangles, XSetDashes, XSetFillRule, XSetFillStyle, XSetForeground, 
XSetFunction, XSetGraphicsExposures, XSetLineAttributes, XSetPlane- 
Mask, XSetState, XSetStipple, XSetTSOrigin. 
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Name 
XSetTextProperty — set one of a window’s text properties. 


Synopsis 
void XSetTextProperty (display, w, text_prop, property) 
Display *display; 
Window w; 
XTextProperty *text_prop; 
Atom property; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
w Specifies the window. 


text_prop Specifies the XText Property structure to be used. 
property Specifies the property name. 


Availability 
Release 4 and later. 


Description 
XSetTextProperty sets the specified property for the named window with the data, type, 
format, and number of items determined by the value field, the encoding field, the format 
field, and the nitems field, respectively, of the specified XText Property Structure. 


Structures 
typedef struct { 
unsigned char *value; /* same as Property routines */ 
Atom encoding; /* prop type */ 
int format; /* prop’ dataltormatls/8i- 16; or 8264 / 
unsigned long nitems; /* number of data items in value */ 
} XText Property; 


Errors 
BadAlloc 
BadAtom 
BadValue 
BadWindow 


Related Commands 
XFreeStringList, XGetTextProperty, XStringListToTextProperty, XText- 
PropertytoStringList. 
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Name ; 
XSetTile — set the fill tile in a graphics context. 
Synopsis 
XSetTile (display, gc, tile) 
Display *display; 
Ge gC; 
Pixmap tile; 


Arguments 


display Specifies a connection to an X server; returned from XOpenDisplay. 

gc Specifies the graphics context. 

tile Specifies the desired tile for the specified graphics context. 
Description 


XSetTile sets the tile member of the GC. This member of the GC determines the pixmap 
used to tile areas. The tile must have the same depth as the destination drawable. This tile will 
only be used in drawing if the £ill-style is FillTiled. 


For more information, see Volume One, Chapter 5, The Graphics Context. 


Errors 
BadGC 
BadMatch 
BadPixmap 


Related Commands 
XCreateBitmapFromData, XCreatePixmap, XCreatePixmapFromBitmapData, 
XFreePixmap, XQueryBestSize, XQueryBestStipple, XQueryBestTile, 
XReadBitmapFile, XSetWindowBackgroundPixmap, XSetWindowBorder- 
Pixmap, XWriteBitmapFile. 
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Name 
XSetTransientForHint — set the XA_WM_ TRANSIENT FOR property for a window. 


Synopsis 
XSetTransientForHint (display, w, prop window) 
Display *display; 
Window w; 
Window prop window; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
Ww Specifies the window ID, normally of a dialog box popup. 


prop _window Specifies the window ID that the XA_WM_TRANSIENT_FOR property is to be 
set to. This is usually the main window of the application. 


Description 
XSetTransientForHint sets the XA_WM TRANSIENT FOR property of the specified win- 
dow. This should be done when the window w is a temporary child (for example, a dialog box) 
and the main top-level window of its application is prop window. Some window managers 
may use this information to unmap an application’s dialog boxes (for example, when the main 
application window gets iconified). 


For more information, see Volume One, Chapter 10, Interclient Communication. 


Errors 
BadAlloc 
BadWindow 


Related Commands 
XFetchName, XGetClassHint, XGet IconName, XGet IconSizes, XGetNormal- 
Hints, XGetSizeHints, XGetTransientForHint, XGetWMHints, XGet Zoom- 
Hints, XSetClassHint, XSetCommand, XSet IconName, XSetIconSizes, XSet- 
NormalHints, XSetSizeHints, XSetWMHints, XSetZoomHints, XStoreName. 
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Name ' 
XSetTSOrigin — set the tile/stipple origin in a graphics context. 


Synopsis 
XSetTSOrigin (display, gc, ts_x_origin, ts_y_origin) 
Display *display; 
CGGugc; 
int Gssx origin, ts_y origin; 
) 


Arguments Ee 
display Specifies a connection to an X server; returned from XOpenDisplay. 
gc Specifies the graphics context. 


ts_x_origin Specify the x and y coordinates of the tile/stipple origin. 
ts_y origin 


Description 
XSetTSOrigin sets the ts_x_origin and ts_y origin components in a GC, which 
are measured relative to the origin of the drawable specified in the drawing request that uses the 
GC. This controls the placement of the tile or the stipple pattern that patterns an area. To tile 
or stipple a child so that the pattern matches the parent, you need to subtract the current posi- 
tion of the child window from ts_x_originandts_y origin. 


For more information, see Volume One, Chapter 5, The Graphics Context. 


Errors 
BadGC 


Related Commands 
DefaultGC, XChangeGC, XCopyGC, XCreateGC, XFreeGC, XGContextFromGC, 
XSetArcMode, XSetBackground, XSetClipMask, XSetClipOrigin, XSetClip- 
Rectangles, XSetDashes, XSetFillRule, XSetFillStyle, XSetForeground, 
XSetFunction, XSetGraphicsExposures, XSetLineAttributes, XSetPlane- 
Mask, XSet State, XSetStipple, XSet SubwindowMode. 
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Name 
XSetWMClientMachine — set a window’s WM_CLIENT_ MACHINE property. 


Synopsis 
void XSetWMClientMachine (display, w, text_prop) 
Display *display; 
Window w; 
XTextProperty *text_prop; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
Ww Specifies the window. 


text_prop Specifies the XText Property structure to be used. 


Availability 
Release 4 and later. 


Description 
XSetWMClientMachine performs an xXSetTextProperty to _ set _ the 
WM CLIENT MACHINE property of the specified window. This property should contain the 
name of the host machine on which this client is being run, as seen from the server. 


For more information, see Volume One, Chapter 10, Interclient Communication. 


Structures 
typedef struct { 
unsigned char *value; /* same as Property routines */ 
Atom encoding; /* prop type */ 
int format; /F*prop data format: *Oe slo, "Orese i / 
unsigned long nitems; /* number of data items in value */ 


} XTextProperty; 


Related Commands 
XGetWMClientMachine. 
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Name 
XSetWMColormapWindows — set a window’s WM_COLORMAP WINDOWS property. 


Synopsis 
Status XSetWMColormapWindows (display, w, colormap_windows, 
count ) 
Display *display; 
Window w; 
Window *colormap_ windows; 
ine count; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
w Specifies the window. 


colormap_windows 
Specifies the list of windows. 


count Specifies the number of windows in the list. 


Availability 
Release 4 and later. 


Description 
XSetWMColormapWindows sets the WM_COLORMAP WINDOWS property on the specified win- 
dow to the list of windows specified by the colormap_windows argument. The property is 
stored with a type of WINDOW and «4 format of 32. If it cannot intern the 
WM COLORMAP WINDOWS atom, XSetWMColormapWindows returns a zero status. Other- 
wise, it returns a non-zero status. 


This property tells the window manager that subwindows of this application need to have their 
own colormaps installed. 


For more information, see Volume One, Chapter 10, Interclient Communication. 
Errors 

BadAlloc 

BadWindow 


Related Commands 
XGetWMColormapWindows. 
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Name 
XSetWMIconName — set a window’s XA_WM_ICON_NAME property. 


Synopsis 
void XSetWMIconName (display, w, text_prop) 
Display *display; 
Window w; 
XTextProperty *text_prop; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
w Specifies the window. 


text _prop Specifies the XText Property structure to be used. 


Availability 
Release 4 and later. 


Description 
XSetWMIconName performs an XSetTextProperty to set the XA_WM_ICON_NAME prop- 
erty of the specified window. xSet WMIconName supersedes XSet IconName. 


This is usually called by an application to set the property for the window manager. The name 
should be short, since it is to be displayed in association with an icon. 


XSetStandardProperties (in Release 4) or XSetWMProperties (in Release 4) also 
set this property. 


For more information, see Volume One, Chapter 10, Interclient Communication. 


Structures 
typedef struct { 
unsigned char *value; /* same as Property routines */ 
Atom encoding; /* prop type */ 
int format; /* prop datastormacw,) Sal, . OnEsole=/ 
unsigned long nitems; /* number of data items in value */ 


} XTextProperty; 


Related Commands 
XGetWMIconName, XGetWMName, XSetWMName, XSetWMProperties. 
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— Xlib — Window Manager Hints XSetWM Name 


Name ‘ 
XSetWMName — set a window’s XA_WM_NAME property. 


Synopsis 
void XSetWMName (display, w, text_prop) 
Display *display; 
Window w; 
ATextProperty *text prop; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
w Specifies the window. 


text_prop Specifies the XText Property structure to be used. 


Availability 
Release 4 and later. 


Description 
XSetWMName performs a XSetTextProperty to set the XA_WM NAME property on the 
specified window. XSetWMName supersedes XStoreName. This property can also be set 
with XSetWMProperties. 


XSetWMName be used by the application to communicate a string to the window manager. 
According to current conventions, this string should either: 


° permit the user to identify one of a number of instances of the same client, or 
° provide the user with noncritical state information. 
Clients can assume that at least the beginning of this string is visible to the user. 


The XA_WM_CLASS property, on the other hand, has two members which should be used to iden- 
tify the application’s instance and class name, for the lookup of resources. See XSetClass- 
Hint for details. 


For more information, see Volume One, Chapter 10, Jnterclient Communication. 


Structures 
typedef struct { 
unsigned char *value; /* same as Property routines */ 
Atom encoding; /* prop type */ 
Int formats /* prop'‘data-format:~8) 16) or'32 */ 
unsigned long nitems; /* number of data items in value */ 
} XTextProperty; 


Related Commands 
XGet WMIconName, XGetWMName, XSet WMIconName, XSetWMProperties. 
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Name 
XSetWMNormalHints — set a window’s XA_WM_NORMAL_HINTS property. 


Synopsis 
void XSetWMNormalHints (display, w, hints) 
Display *display; 
Window w; 
XSizeHints *hints; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
w Specifies the window. 
hints Specifies the size hints for the window in its normal state. 
Availability 


Release 4 and later. 


Description 
XSetWMNormalHints sets the size hints in the XA_WM NORMAL HINTS property on the 
specified window. The property is stored with a type of WM_SIZE_HINTS and a format of 32. 
XSetWMNormalHints supersedes XSetNormalHints. This property can also be set with 
XSetWMProperties. 


Applications use XSetNormalHints to inform the window manager of the sizes desirable 
for that window. 


To set size hints, an application must assign values to the appropriate elements in the hints 
structure, and also set the flags field of the structure to indicate which members have 
assigned values and the source of the assignment. These flags are listed in the Structures sec- 
tion below. 


For more information, see Volume One, Chapter 10, Interclient Communication. 


Structures 
typedef struct { 
long flags; /* marks which fields in this structure */ 
/* are defined */ 
EL TicaeXCpue Ws /* obsolete for new window mgrs, but clients */ 


int width, height; /* should set so old wm’s don’t mess up */ 
int min_width, min_height; 
int max_width, max_height; 
int width _inc, height_inc; 
Struck 
int x; /* numerator */ 
int y; /* denominator */ 
} min_aspect, max_aspect; 
int base width, base height; /* added by ICCCM version 1 */ 
int win gravity; /* added by ICCCM version 1 */ 
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} XSizeHints; 


#define 
#define 


#define 
*7. 
#define 
#define 
#define 
#define 
/ 
#define 


USPosition (1L 
USSize (iL 


PPosition (1L 
PSize (1L 
PMinSize Cnt 


PMaxSize (1L 
PResizelInc (1L 


PAspect (1L 


ratios */ 
PA11Hints (PPosition|PSize|PMinSize|PMaxSize|PResizelInc|PAspect) 
/* program specified base 

for incrementing */ 

#define PWinGravity (1L << 9)/* program specified window 


#define 
#define 


Errors 


<< 
<< 


<< 
<< 
<< 


<< 
<< 


<< 


0) 
1) 


2) 
3) 
A) 


5) 
6) 


7) 


PBaseSize (1L << 8) 


BadAlloc 
BadWindow 


Related Commands 
XGetWMNormalHints, XSetWMProperties, XSetWMSizeHints, XGetWMSize- 


Hints. 
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/* 
/* 
/* 
/* 
/* 
/* 
/* 


/* 


(continued) 
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user specified x, y */ 
user specified width, height */ 


program 
program 
program 
program 


program 


program 


gravity 


specified position 
specified size */ 
specified minimum size */ 
specified maximum size */ 


specified resize increments * 


specified min/max aspect 


ay 
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Name 
XSetWMProperties — set a window’s standard window manager properties. 


Synopsis 
void XSetWMProperties (display, w, window_name, icon_name, argv, 
argc, normal_ hints, wm_hints, class_hints) 
Display *display; 
Window w; 
XTextProperty *window_name; 
XTextProperty *icon_name; 
char **argv; 
itech 
XSizeHints *normal_hints; 
XWMHints *wm_hints; 
XClassHint *class_hints; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
w Specifies the window. 


window name Specifies the window name, which should be a null-terminated string. 
icon_name Specifies the icon name, which should be a null-terminated string. 
argv Specifies the application’s argument list. 

argc Specifies the number of arguments. 


normal _hints 
Specifies the size hints for the window in its normal state. 


wm_ hints Specifies the XWMHints structure to be used. 


class_hints Specifies the XClassHint structure to be used. 


Availability 
Release 4 and later. 


Description 
XSetWMProperties provides a single programming interface for setting the essential win- 
dow properties that communicate with window and session managers. XSetWMProperties 
supersedes XSetStandardProperties. 


If the window _name argument is non-null, XSetWMProperties calls xSetWMName, 
which, in turn, sets the WM NAME property. If the icon_name argument is non-null, xSet - 
WMP roperties calls XSetWMIconName, which sets the WM_ICON NAME property. If the 
argv argument is non-null, XSetWMProperties calls XSetCommand, which sets the 
WM COMMAND property. Note that an argc of 0 is allowed to indicate a zero-length command. 
XSetWMP roperties stores the hostname of this machine using XSetWMClientMachine. 
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If the normal_hints argument is non-null, XsetWMProperties calls XSetWMNormal- 
Hints, which sets the WM NORMAL HINTS property. If the wm_hints argument is non-null, 
XSetWMP roperties calls XSetWMHints, which sets the WM_HINTS property. 


If the class_hints argument is non-null, XSetWMProperties calls XSetClassHint, 
which sets the WM_CLASS property. If the res_name member in the XClassHint Structure 
is set to the null pointer and the RESOURCE_NAME environment variable is set, then value of 
the environment variable is substituted for res name. If the res_name member is NULL, 
and if the environment variable is not set, and if argv and argv [0] are set, then the value of 
argv [0], stripped of any directory prefixes, is substituted for res_ name. 


For more information, see Volume One, Chapter 10, Interclient Communication. 


Structures 
typedef struct { 
unsigned char *value; /* same as Property routines */ 
Atom encoding; /* prop type */ 
int format; /*® prop data format< 8, . U6). om 32a 
unsigned long nitems; /* number of data items in value */ 


} XTextProperty; 


typedef struct { 


long flags; /* marks which fields in this structure */ 

/* are defined */ 
eee xs Vs /* obsolete for new window mgrs, but clients */ 
int width, height; /* should set so old wm’s don’t mess up */ 


int min width, min_height; 
int max_width, max_height; 
int width inc, height inc; 
struck) { 
int x; /* numerator */ 
int y; /* denominator */ 
} min_aspect, max_aspect; 
int base width, base height; /* added by ICCCM version 1 */ 
int win gravity; /* added by ICCCM version 1 */ 
} XSizeHints; 


typedef struct { 


long flags; /* marks which fields in this structure */ 
/* are defined */ 

Bool input; /* does this application rely on the window */ 
/* manager to get keyboard input? */ 

int initial state; /* see below */ 

Pixmap icon_pixmap; /* pixmap to be used as icon */ 

Window icon window; /* window to be used as icon */ 

int icon x, eon. y; j/* initial posmcion of Leon. */ 

Pixmap icon_mask; /* icon mask bitmap */ 
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XID window group; /* id of related window group */ 
/* this structure may be extended in the future */ 
} XWMHints; 


Gypedenrssenuce { 
Chas hese mame, 
Char ores Telassi, 

} XClasshint,; 


Errors 
BadAlloc 
BadWindow 


Related Commands 
XGetClassHints, XGetCommand, XGetWMHints, XGetWMIconName, XGetWMName, 
XGetWMNormalHints, XSetWMClientMachine, XSetWMColormapWindows, XSet- 
WMProtocols. 
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Name 
XSetWMProtocols — set a window’s WM_ PROTOCOLS property. 


Synopsis 
Status XSetWMProtocols (display, w, protocols, count) 
Display *display; 
Window w; 
Atom *protocols; 
ant count; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
w Specifies the window. ; 


protocols Specifies the list of protocols. 


count Specifies the number of protocols in the list. 


Availability 
Release 4 and later. 


Description 
XSetWMProtocols sets the WM PROTOCOLS property on the specified window to the list of 
atoms specified by the protocols argument. The property is stored with a type of ATOM and a 
format of 32. If it cannot intern the WM_PROTOCOLS atom, XSetWMProtocols retums a zero 
status. Otherwise, it returns a non-zero status. 


The list of standard protocols at present is as follows: 


WM_TAKE FOCUS Assignment of keyboard focus 
WM_SAVE_ YOURSELF Save client state warning 
WM DELETE UNKNOWN Request to delete top-level window 


For more information, see Volume One, Chapter 10, Interclient Communication. 


Errors 
BadAlloc 
BadwWindow 


Related Commands 
XGetWMProtocols. 
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Name 
XSetWMSizeHints — set a window’s WM_SIZE_HINTS property. 


Synopsis 
void XSetWMSizeHints (display, w, hints, property) 
Display *display; 
Window w; 
XSizeHints *hints; 
Atom property; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
Ww Specifies the window. 
hints Specifies the XSizeHints structure to be used. 


property Specifies the property name. 


Availability 
Release 4 and later. 


Description 
XSetWMSizeHints sets the size hints for the specified property on the named window. The 
property is stored with a type of WM_SIZE_HINTS and a format of 32. To set a window’s nor- 
mal size hints, you can use the XSetWMNormalHints function instead. xSetWMSize- 
Hints supersedes XSetSizeHints. 


This routine is useful if new properties of type XA_WM_SIZE_HINTS are defined. 


The flags member of XSizeHints must be set to the OR of the symbols representing each 
member to be set. 


For more information, see Volume One, Chapter 10, Interclient Communication. 


Structures 
typedef struct { 
long flags; /* marks which fields in this structure are */ 
/* defined as */ 
inte. Ve /* obsolete for new window mgrs, but clients */ 


int width, height; /* should set so old wm’s don’t mess up */ 
int min_width, min_height; 
int max_width, max_height; 
int width_inc, height_inc; 
Struce { 
int x; /* numerator */ 
int y; /* denominator */ 
} min_aspect, max_aspect; 
int base width, base_height; /* added by ICCCM version 1 */ 
int win_gravity; /* added by ICCCM version 1 */ 
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} XSizeHints; 


#define 
#define 


#define 
*/ 
#define 
#define 
#define 
#define 
if 
#define 


USPosition (1L 
USSize (1L 


PPosition (1L 
PSize (abe, 
PMinSize (1L 


PMaxSize (1L 
PResizelInc (1L 


PAspect (1L 


ratios */ 
#define PAl1Hints (PPosition|PSize|PMinSize|PMaxSize|PResizelInc|PAspect) 
/* program specified base 

for incrementing */ 
#define PWinGravity (1L << 9)/* program specified window 


#define 


Errors 


<< 
<< 


<< 
<< 
<< 


<< 
<< 


<< 


0) 
1) 


2) 
3) 
4) 


5) 
6) 


wey 


PBaseSize (1L << 8) 


BadAlloc 


BadAtom 


BadWindow 


Related Commands 
XAllocSizeHints, XGetWMNormalHints, XGetWMSizeHints, XSetWMNormal- 


Hints. 
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ea Ser specified Xp Ven? 
/* user specified width, height */ 


/* program 
/* program 
/* program 
/* program 


/* program 


/* program 


gravity 


specified 
specified 
specified 
specified 


specified 


specified 


ae 


position 

size */ 

minimum size */ 
maximum size */ 


resize increments * 


min/max aspect 
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Name 
XSetWindowBackground — set the background pixel value attribute of a window. 


Synopsis 
XSetWindowBackground (display, w, background_pixel) 
Display *display; 
Window w; 
unsigned long background_pixel; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
w Specifies the window ID. Must be an Input Output window. 
background_pixel 


Specifies which entry in the colormap is used as the background color. The 
constant CopyFromParent is NOT valid. 


Description 
XSetWindowBackground sets the background attribute of a window, setting the pixel 
value to be used to fill the background. This overrides any previous call to XSetWindow- 
Background or XSetWindowBackgroundPixmap on the same window. 


XSetWindowBackground does not change the current window contents immediately. The 
background is automatically repainted after Expose events. You can also redraw the back- 
ground without Expose events by calling XClearWindow immediately after. 


For more information, see Volume One, Chapter 4, Window Attributes. 
Errors 

BadMatch Setting background of Input Only window. 

BadWindow 


Related Commands 
XChangeWindowAttributes, XGetGeomet ry, XGetWindowAttributes, XSet- 
WindowBackgroundPixmap, XSetWindowBorder, XSetWindowBorderPixmap. 
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Name ; 
XSetWindowBackgroundPixmap — change the background tile attribute of a window. 


Synopsis 
XSetWindowBackgroundPixmap (display, w, background_tile) 
Display *display; 
Window w; 
Pixmap background_tile; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 


w Specifies the window ID. Must be an Input Output class window. 


background_tile 
Specifies a pixmap ID, None or ParentRelative, to be used as a back- 
ground. 


Description - 
XSetWindowBackgroundPixmap sets the background_pixmap attribute of a window. 
This overrides any previous background_pixel or background_pixmap attribute set- 
ting set with XSetWindowBackgroundPixmap, XSetWindowBackground, or 
XChangeWindowAttributes. Drawing into the pixmap that was set as the background 
pixmap attribute has an undefined effect on the window background. The server may or may 
not make a copy of the pixmap. 


If the background is set to a pixmap, the background is tiled with the pixmap. If the pixmap is 
not explicitly referenced again, it can be freed, since a copy is maintained in the server. The 
background of the window will not be redrawn with the new tile until the next Expose event 
or XClearWindow call. 


If the background is set to None, The window background initially will be invisible and will 
share the bits of its parent, but only if the background_pixel attribute is not set. When 
anything is drawn by any client into the area enclosed by the window, the contents will remain 
until the area is explicitly cleared with XClearWindow. The background is not automatically 
refreshed after exposure. 


If the background is set to ParentRelative, the parent’s background is used, and the origin 
for tiling is the parent’s origin (or the parent’s parent if the parent’s background_pixmap 
attribute is also ParentRelative, and so on). The difference between setting Parent- 
Relative and explicitly setting the same pixmap as the parent is the origin of the tiling. The 
difference between ParentRelative and None is that for ParentRelative the back- 
ground is automatically repainted on exposure. 


For ParentRelative, the window must have the’same depth as the parent, or a BadMatch 
error will occur. If the parent has background None, then the window will also have back- 
ground None. The parent’s background is re-examined each time the window background is 
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required (when it needs to be redrawn due to mapping or exposure). The window’s contents 
will be lost when the window is moved relative to its parent, and the contents will have to be 
redrawn. 


Changing the background_pixmap attribute of the root window to None or Parent— 
Relative restores the default. 


XSetWindowBackgroundPixmap can only be performed on an InputOutput window. 
A BadMatch error will result otherwise. 


XSetWindowBackground may be used if a solid color instead of a tile is desired. 


For more information, see Volume One, Chapter 4, Window Attributes. 


Errors 
BadMatch 
BadPixmap 
BadWindow 


Related Commands 
XCreateBitmapFromData, XCreatePixmap, XCreatePixmapFromBitmapData, 
XFreePixmap, XQueryBestSize, XQueryBestStipple, XQueryBestTile, 
XReadBitmapFile, XSetTile, XSetWindowBorderPixmap, XWriteBitmapFile. 


494 Xlib Reference Manual 


—Xtib ~ Window Attributes —————— XSetWindowBorder 


Name ‘ 
XSetWindowBorder — change a window border pixel value attribute and repaint the border. 
Synopsis 
XSetWindowBorder (display, w, border_pixel) 
Display *display; 
Window w; 
unsigned long border pixel; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
Ww Specifies the window ID. Must be an Input Output window. 
border pixel 


Specifies the colormap entry with which the server will paint the border. 


Description | 
XSetWindowBorder sets the border pixel attribute of window w to a pixel value, and 
repaints the border. The border is also automatically repainted after Expose events. 


Use XSetWindowBorderPixmap to create a tiled border. On top-level windows, the win- 
dow manager often resets the border, so applications should not depend on their settings. 


For more information, see Volume One, Chapter 4, Window Attributes. 
Errors 

BadMatch Setting border of Input Only window. 

BadWindow 


Related Commands 
XChangeWindowAttributes, XGetGeomet ry, XGetWindowAttributes, XSet- 
WindowBackground, XSetWindowBackgroundPixmap, XSetWindowBorder- 
Pixmap. 
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Name 
XSetWindowBorderPixmap — change a window border tile attribute and repaint the border. 


Synopsis 
XSetWindowBorderPixmap (display, w, border _tile) 
Display *display; 
Window w; 
Pixmap border tile; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
w Specifies the ID of an Input Output window whose border is to be to a file. 


border tile Specifies any pixmap or None. 


Description 
XSetWindowBorderPixmap sets the border _pixmap attribute of a window and repaints 
the border. The border tile can be freed immediately after the call if no further explicit 
references to it are to be made. 


This function can only be performed on an InputOutput window. On top-level windows, — 
the window manager often resets the border, so applications should not depend on their set- 
tings. 


Errors 
BadMatch 
BadPixmap 
BadWindow 


Related Commands 
XCreateBitmapFromData, XCreatePixmap, XCreatePixmapFromBitmapData, 
XFreePixmap, XQueryBestSize, XQueryBestStipple, XQueryBestTile, 
XReadBitmapFile, XSetTile, XSetWindowBackgroundPixmap, XWriteBitmap- 
File. 
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‘4 


Name 
XSetWindowBorderWidth — change the border width of a window. 


Synopsis 
XSetWindowBorderWidth (display, w, width) 
Display *display; 
Window w; 
unsigned int width; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
w Specifies the ID of the window whose border is to be changed. 
width Specifies the width of the window border. 

Description 


XSetWindowBorderWidth changes the border width of a window. This request is often 
used on top-level windows by the window manager as an indication of the current keyboard 
focus window, so other clients should not depend on the border width of top-level windows. 


Errors 
BadMatch Setting border width of an Input Only window. 


BadWindow 


Related Commands 
XCirculateSubwindows, XCirculateSubwindowsDown, XCirculate- 
SubwindowsUp, XConfigureWindow, XLowerWindow, XMoveResizeWindow, 
XMoveWindow, XQueryTree, XRaiseWindow, XReparentWindow, XResize- 
Window, XRestackWindows. 
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Name 
XSetWindowColormap — set the colormap attribute for a window. 


Synopsis 
XSetWindowColormap (display, w, cmap) 
Display *display; 
Window w; 
Colormap cmap; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
w Specifies the ID of the window for which you want to set the colormap. 
cmap Specifies the colormap. 

Description 


XSetWindowColormap sets the colormap attribute of the specified window. The color- 
map need not be installed to be set as an attribute. cmap will be used to translate pixel values 
drawn into this window when cmap is installed in the hardware, which will be taken care of by 
the window manager. 


In Release 3, applications must install their own colormaps if they cannot use the default color- 
map. In Release 4, they should never do so. 


The colormap must have the same visual as the window. 


Errors 
BadColormap 
BadMatch 
BadWindow 


Related Commands 
XChangeWindowAttributes, XGetGeomet ry, XGetWindowAttributes, xSet- 
WindowBackground, XSetWindowBackgroundPixmap, XSetWindowBorder, 
XSetWindowBorderPixmap, XSetWMColormapWindows. 
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‘ 


Name 
XSetWMHints — set a window manager hints property. 


Synopsis 
XSetWMHints (display, w, wmhints) 
Display *display; 
Window w; 
XWMHints *wmhints; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 


w Specifies the ID for which window manager hints are to be set. 
wmhints Specifies a pointer to the window manager hints. 


Description 
XSetWMHints sets the window manager hints that include icon information and location, the 
initial state of the window, and whether the application relies on the window manager to get 
keyboard input. 


This function is unnecessary in Release 4 if you call XSet WMP roperties. 


See Volume One, Chapter 10, Interclient Communication, for a description of each XWMHints 
structure member. 


Structures 
typedef struct { 
long flags; /* marks defined fields in structure */ 
Bool input; /* does application need window manager for 
* keyboard input */ 
imt init val ‘state; /* see below */ 


Pixmap icon _pixmap; /* pixmap to be used as icon */ 
Window icon window; /* window to be used as icon */ 
int, Leon x, LCOn yy Y* anttial posteion of 1eon, </ 


Pixmap icon_mask; /* icon mask bitmap */ 
XID window _group; /* ID of related window group */ 
/* this structure may be extended in the future */ 

} XWMHints; 


/* definitions for the flags field: */ 


#define InputHint (Atie<< 0) 
#define StateHint (MO << 1) 
#define IconPixmapHint (TiES< 2) 
#define IconWindowHint (iT << 3) 
#define IconPositionHint (1L << 4) 
#define IconMaskHint (LiL F< < 5h). 


#define WindowGroupHint ME <<, 16) 
#define AllHints (InputHint|StateHint|IconPixmapHint|IconWindowHint| \ 
IconPositionHint | IconMaskHint |WindowGroupHint) 
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/* definitions for the initial state flag: */ 


#define 
#define 
#define 
#define 
#define 


Errors 
BadAlloc 
BadWindow 


DontCareState 
NormalState 
ZoomState 
IconicState 
InactiveState 


Related Commands 
XAlLlLOocWMHints, XFetchName, XGetClassHint, XGetIconName, XGetIcon- 
Sizes, XGetNormalHints, XGetSizeHints, XGetTransientForHint, XGet- 
WMHints, XGetZoomHints, XSetClassHint, XSetCommand. XSetIconName, 
XSetIconSizes, XSetNormalHints, XSetSizeHints, XSetTransientForHint, 
XSetZoomHints, XStoreName, XSetWMProperties. 
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0 


1 
2 
3 
4 


/* 
/* 
/* 
/* 
/* 


don’t know or care */ 

most applications want to start this way */ 
application wants to start zoomed */ 
application wants to start as an icon */ 
application believes it is seldom used; 
some wm’s may put it on inactive menu */ 
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‘ 


Name 
XSetZoomHints — set the size hints property of a zoomed window. 


Synopsis 
XSetZoomHints (display, w, zhints) 
Display *display; 
Window w; 
XSizeHints *zhints; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
w Specifies the ID of the window for which zoom hints are to be set. 
zhints Specifies a pointer to the zoom hints. 

Description } 


XSet ZoomHints is no longer used as of Release 3. 


XSetZoomHints sets the XA_WM_Z00M HINTS property for an application’s top-level win- 
dow in its zoomed state. Many window managers think of windows in three states: iconified, 
normal, or zoomed, corresponding to small, medium, and large. Applications use XxSet Zoom- 
Hints to inform the window manager of the size or position desirable for the zoomed window. 


In addition, an application wanting to move or resize its zoomed window should call xSet- 
ZoomHints specifying its new desired location and size, in addition to making direct X calls 
to move or resize. This is because some window managers may redirect window configuration 
requests, but ignore the resulting events and pay attention to property changes instead. 


To set size hints, an application must assign values to the appropriate elements in the hints 
structure, and set the flags field of the structure to indicate which members have assigned 
values and the source of the assignment. These flags are listed in the Structures section below. 


For more information on using hints, see Volume One, Chapter 10, Interclient Communication. 


Structures 
typedef struct { 

long flags; /* marks defined fields in structure */ 
imi ee, “Yo. 
int width, height; 
int min_width, min_height; 
int max_width, max_height; 
int width_inc, height _inc; 


struct { 
ar ace /* numerator */ 
inte yy /* denominator */ 


} min_aspect, max_aspect; 
/* new fields in R4 */ 
} XSizeHints; 
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<< 
<< 


<< 
<< 
<< 
<< 
KS 
<< 
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/* user specified width, height */ 


position */ 

size */ 

minimum size */ 
maximum size */ 
resize increments */ 


(continued) 
hints */ 
0) /* user specified x, y */ 
1) 
2) /* program specified 
3) /* program specified 
4) /* program specified 
5) /* program specified 
6) /* program specified 
7) /* program specified 


min/max aspect ratios */ 


PAllHints (PPosition|PSize|PMinSize|PMaxSize|PResizelInc|PAspect) 


#define USPosition (1L 
#define USSize (1L 
#define PPosition (1L 
#define PSize (1L 
#define PMinSize (1L 
#define PMaxSize (aT: 
#define PResizelInc (1L 
#define PAspect (elas 
#define 

Errors 
BadAlloc 
BadWindow 


Related Commands 
XFetchName, XGetClassHint, XGetIconName, XGetIconSizes, XGetNormal- 
Hints, XGetSizeHints, XGetTransientForHint, XGetWMHints, XGetZoom- 
Hints, XSetClassHint, XSetCommand, XSet IconName, XSetIconSizes, XSet- 
NormalHints, XSetSizeHints, XSetTransientForHint, XSetWMHints, 
XStoreName. 


502 


Xlib Reference Manual 


—Xlib — Regions ) XShrinkRegion 


Name : : 
XShrinkRegion — reduce or expand the size of a region. 
Synopsis 
XShrinkRegion(r, dx, dy) 
Region r; 
int dx, dy; 
Arguments 
¥ Specifies the region. 
dx Specify the amounts by which you want to shrink or expand the specified 
dy region. Positive values shrink the region while negative values expand the 
region. 
Description 


XShrinkRegion changes the width and/or height of the specified region. Positive values 
shrink the region; negative values expand the region. It is legal to expand the region in one 
dimension at the same time as shrinking it in the other dimension. The offset of the region is 
changed to keep the center of the resized region near its original position. 


The exact amount of shrinkage for a given value for dx or dy is not specified by Xlib. 


Structures 
Region is a pointer to an opaque structure type. 


Related Commands 
XClipBox, XCreateRegion, XDest royRegion, XEmptyRegion, XEqualRegion, 
XIntersectRegion, XOffsetRegion, XPointInRegion, XPolygonRegion, 
XRect InRegion, XSetRegion, XSubt ractRegion, XUnionRectWithRegion, 
XUnionRegion, XXorRegion. 
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Name 
XStoreBuffer — store data in a cut buffer. 


Synopsis 
XStoreBuffer (display, bytes, nbytes, buffer) 
Display *display; 
char bytes[]; 
int nbytes; 
int buffer; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
bytes Specifies the string of bytes you want stored. The byte string is not necessarily 
ASCII or null-terminated. 
nbytes Specifies the number of bytes in the string. 
buffer Specifies the cut buffer in which to store the byte string. Must be in the range 
0-7. 
Description 


XStoreBuffer stores the specified data into any one of the eight cut buffers. All eight buf- 
fers must be stored into before they can be circulated with XRotateBuffers. The cut buf- 
fers are numbered 0 through 7. Use XFet chBuf fer to recover data from any cut buffer. 


Note that selections are the preferred method of transferring data between applications. 


For more information on cut buffers, see Volume One, Chapter 13, Other Programming Tech- 
niques. For more information on selections, see Volume One, Chapter 10, Interclient Commu- 
nication. 


Errors 
BadAlloc 
BadAtom 


Related Commands 
XFetchBuffer, XFetchBytes, XRotateBuffers, XStoreBytes. 
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Name | 
XStoreBytes — store data in cut buffer 0. 


Synopsis 
XStoreBytes (display, bytes, nbytes) 
Display *display; 
ehar—bytes[]; 
int nbytes; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
bytes Specifies the string of bytes to store. The byte string is not necessarily ASCII or 
null-terminated. 
nbytes Specifies the number of bytes to store. 
Description 


XStoreBytes stores data in cut buffer 0, usually for reading by another client that already 
knows the meaning of the contents. Note that the cut buffer’s contents need not be text, so null 
bytes are not special. 


The cut buffer’s contents may be retrieved later by any client calling XFetchBytes. 


Use XStoreBuffer to store data in buffers 1-7. Note that selections are the preferred 
method of transferring data between applications. 


For more information on cut buffers, see Volume One, Chapter 13, Other Programming Tech- 
niques. For more information on selections, see Volume One, Chapter 10, Interclient Commu- 
nication. 


Errors 
BadAlloc 


Related Commands 
XFetchBuffer, XFetchBytes, XRotateBuffers, XStoreBuffer. 
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Name 
XStoreColor — set or change the RGB values of a read/write colormap entry to the closest pos- 
sible hardware color. 


Synopsis 
XStoreColor (display, cmap, colorcell_def) 
Display *display; 
Colormap cmap; 
RMCohorr*colorcell def; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
cmap Specifies the colormap. 


colorcell_def Specifies a pixel value and the desired RGB values. 


Description 
XStoreColor changes the RGB values of a colormap entry specified by 
colorcell_def.pixel to the closest values possible on the hardware. This pixel value 
must be a read/write cell and a valid index into cmap. XStoreColor changes the red, green, 
and/or blue color components in the cell according to the colorcell_def.flags member, 
which you set by ORing the constants DoRed, DoGreen, and/or DoBlue. 


If the colormap is an installed map for its screen, the changes are visible immediately. 
For more information, see Volume One, Chapter 7, Color. 

Structures 
typedef struct { 


unsigned long pixel; 
unsigned short red, green, blue; 


char flags; /* DoRed, DoGreen, DoBlue */ 
char pad; 
} xColors 
Errors 
BadAccess A specified pixel is unallocated or read-only. 
BadColormap 
BadValue pixel not valid index into cmap. 


Related Commands 
BlackPixel, WhitePixel, XAllocColor, XAllocColorCells, XAllocColor- 
Planes, XAllocNamedColor, XFreeColors, XLookupColor, XParseColor, 
XQueryColor, XQueryColors, XStoreColors, XStoreNamedColor. 
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Name 
XStoreColors — set or change the RGB values of read/write colorcells to the closest possible 
hardware colors. 


Synopsis 
XStoreColors (display, cmap, colorcell_defs, ncolors) 
Display *display; 
Colormap cmap; 
XColor colorcell_ defs[ncolors]; 
int nedLlors; si 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 


cmap Specifies the colormap. 


colorcell_defs 
Specifies an array of color definition structures. 


ncolors Specifies the number of XColor structures in colorcell_defs. 


Description 
XStoreColors changes the RGB values of each colormap entry specified by color- 
cell _defs[].pixel to the closest possible hardware colors. Each pixel value must be a 
read/write cell and a valid index into cmap. XStoreColors changes the red, green, and/or 
blue color components in each cell according to the colorcell_defs[].flags member, 
which you set by ORing the constants DoRed, DoGreen, and/or DoBlue. The specified pix- 
els are changed if they are writable by any client, even if one or more pixels generates an error. 


If the colormap is an installed map for its screen, the changes are visible immediately. For 
more information, see Volume One, Chapter 7, Color. 


Structures 
typedef struct { 
unsigned long pixel; 
unsigned short red, green, blue; 


char flags; /* DoRed, DoGreen, DoBlue */ 
char pad; 
}_XColox; 
Errors 
BadAccess A specified pixel is unallocated or read-only. 
BadColormap 
BadValue A specified pixel is not a valid entry into cmap. 


_ Related Commands 

-BlackPixel, WhitePixel, XAllocColor, XAllocColorCells, XAllocColor- 
Planes, XAllocNamedColor, XFreeColors, XLookupColor, XParseColor, 
XQueryColor, XQueryColors, XStoreColor, XStoreNamedColor. 
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Name 
XStoreName — assign a name to a window for the window manager. 


Synopsis 
XStoreName (display, w, window_name) 
Display *display; 
Window w; 
char *window_name; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
w Specifies the ID of the window to which you want to assign a name. 


window_name Specifies the name of the window. The name should be a null-terminated 
string. This name is returned by any subsequent call to XFet chName. 


Description 
XStoreName is superceded in Release 4 by XSet WMName. 


XStoreName sets the XA_WM NAME property, which should be used by the application to com- 
municate the following information to the window manager, according to current conventions: 


° To permit the user to identify one of a number of instances of the same client. 
° To provide the user with noncritical state information. 
Clients can assume that at least the beginning of this string is visible to the user. 


The XA_WM CLASS property, on the other hand, has two members which should be used to iden- 
tify the application’s instance and class name, for the lookup of resources. See XSetClass- 
Hint for details. 


For more information, see Volume One, Chapter 10, Interclient Communication. 


Errors 
BadAlloc 
BadwWindow 


Related Commands 
XFetchName, XGetClassHint, XGet IconName, XGetIconSizes, XGetNormal- 
Hints, XGetSizeHints, XGetTransientForHint, XGetWMHints, XGet Zoom- 
Hints, XSetClassHint, XSetCommand, XSet IconName, XSet IconSizes, XSet- 
NormalHints, XSetSizeHints, XSetTransientForHint, XSetWMHints, XSet- 
ZoomHints. 
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Name : 
XStoreNamedColor — set RGB values of a read/write colorcell by color name. 


Synopsis 
XStoreNamedColor (display, cmap, colorname, pixel, flags) 
Display *display; 
Colormap cmap; 
char *colorname; 
unsigned long pixel; 


int flags; 
Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
cmap Specifies the colormap. 


colorname Specifies the color name string (for example, “red”). This cannot be in hex for- 
mat (as used in XParseColor). Upper or lower case is not important. The 
string should be in ISO LATIN-1 encoding, which means that the first 128 char- 
acter codes are ASCII, and the second 128 character codes are for special char- 
acters needed in western languages other than English. 


pixel Specifies the entry in the colormap to store color in. 
flags Specifies which red, green, and blue indexes are set. 
Description 


XStoreNamedColor looks up the named color in the database, with respect to the screen 
associated with cmap, then stores the result in the read/write colorcell of cmap specified by 
pixel. Upper or lower case in name does not matter. The flags argument, a bitwise OR of 
the constants DoRed, DoGreen, and DoBlue, determines which subfields within the pixel 
value in the cell are written. 


For more information, see Volume One, Chapter 7, Color. 


Errors 
BadAccess pixel is unallocated or read-only. 
BadColormap 
BadName colorname is not in server’s color database. 
BadValue pixel] is nota valid index into cmap. 


Related Commands 
DefaultColormap, DisplayCells, XCopyColormapAndF ree, XCreate- 
Colormap, XFreeColormap, XGetStandardColormap, XInstallColormap, 
XListInstalledColormaps, XSetStandardColormap, XSetWindowColormap, 
-XUninstallColormap. 
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Name 
XStringListToTextProperty — set the specified list of strings to an XText Property struc- 
ture. 
Synopsis 


Status XStringListToTextProperty (list, count, text_prop) 
char **list; 
inte Count: 


.XTextProperty *text_prop; /* RETURN */ 
Arguments 
La Se Specifies a list of null-terminated character strings. 
count Specifies the number of strings. 


text_prop Returns the XText Property structure. 


Availability 
Release 4 and later. 


Description 

XStringListToTextProperty fills the specified xTextProperty structure so that it 
represents a property of type STRING (format 8) with a value representing the concatenation of 
the specified list of null-separated character strings. An extra byte containing NULL (which is 
not included in the nitems member) is stored at the end of the value field of text_prop. 
If insufficient memory is available for the new value string, XStringListToText- 
Property does not set any fields in the XText Property structure and returns a zero status. 
Otherwise, it returns a non-zero status. To free the storage for the value field, use XF ree. 


For more information, see Volume One, Chapter 10, /nterclient Communication. 


Structures 
typedef struct { 
unsigned char *value; /* same as Property routines */ 
Atom encoding; /* prop type */ 
imi Lommats /* prop data format: 8, 16.) or soon 
unsigned long nitems; /* number of data items in value */ 


} XTextProperty; 


Related Commands 
XSetTextProperty, AGeU Leer FORpeY ty, XTextPropertyToStringList, 
XFreeStringList. 
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Name 
XStringToKeysym — convert a keysym name string to a keysym. 


Synopsis 
KeySym XStringToKeysym (string) 
ener “string; 


Arguments # 
string Specifies the name of the keysym that is to be converted. 


Description 
XStringToKeysym translates the character string version of a keysym name (“Shift”) to the 
matching keysym which is a constant (XK_Shift). Valid keysym names are listed in 
<X11/keysymdef.h>. If the specified string does not match a valid keysym, XString- 
ToKeysymretums NoSymbol. 


This string is not the string returned in the buffer argument of XLookupSt ring, which can 
be set with XRebindKeysym. If that string is used, XSt ringToKeysym will return No- 
Symbol except by coincidence. 


In Release 4, XSt ringToKeysym can return keysyms that are not defined by the Xlib stan- 
dard. Note that the set of keysyms that are available in this manner and the mechanisms by 
which Xlib obtains them is implementation dependent. (In the MIT sample implementation, 
the resource file /usr/lib/X11/XKeysymDB is used starting in Release 4. The keysym name is 
used as the resource name, and the resource value is the keysym value in uppercase hexade- 
cimal.) 


For more information, see Volume One, Chapter 9, The Keyboard and Pointer. 


Reiated Commands 
XChangeKeyboardMapping, XDeleteModifiermapEntry, XFreeModifiermap, 
XGetKeyboardMapping, XGetModifierMapping, XInsertModifiermapEntry, 
XKeycodeToKeysym, XKeysymToKeycode, XKeysymToString, XLookupKeysym, 
XLookupSt ring, XNewModifierMap, XQueryKeymap, XRebindKeysym, 
XRefreshKeyboardMapping, XSetModifierMapping. 
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Name 


XSubImage — create a subimage from part of an image. 


Synopsis 


XImage *XSubImage (ximage, x, y, Subimage_ width, subimage_height) 
XImage *ximage; 
STA AV 
unsigned int subimage_width; subimage_height; 


Arguments 
ximage Specifies a pointer to the image. 
x Specify the x and y coordinates in the existing image where the subimage will be 
y extracted. 


subimage_ width 
subimage_height 
Specify the width and height (in pixels) of the new subimage. 


Description 


XSubImage creates a new image that is a subsection of an existing one. It allocates the mem- 
ory necessary for the new XImage structure and returns a pointer to the new image. The data 
is copied from the source image, and the rectangle defined by x, y, subimage_width, and 
subimage_height must by contained in the image. 


XSubImage extracts a subimage from an image, while XGet SubImage extracts an image 
from a drawable. 


For more information on images, see Volume One, Chapter 6, Drawing Graphics and Text. 


Related Commands 
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ImageByteOrder, XAddPixel, XCreateImage, XDest royImage, XGet Image, 
XGetPixel, XGetSubImage, XPut Image, XPutPixel. 
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Name ; 
XSubtractRegion — subtract one region from another. 
Synopsis 
XSubtractRegion(sra, srb, dr) 
Region sra, srb; 


Region dr; /* RETURN */ 
Arguments 
sra Specify the two regions in which you want to perform the computation. 
Se 
dr Returns the result of the computation. 
Description 


XSubt ractRegion calculates the difference between the two regions specified (sra - srb) 
and puts the result in dr. 


This function returns a region which contains all parts of sra that are not also in srb. 
For more information on regions, see Volume One, Chapter 6, Drawing Graphics and Text. 


Structures 
Region is a pointer to an Opaque structure type. 


Reiated Commands 
XClipBox, XCreateRegion, XDest royRegion, XEmptyRegion, XEqualRegion, 
XIntersectRegion, XOffsetRegion, XPointInRegion, XPolygonRegion, 
XRectInRegion, XSetRegion, XShrinkRegion, XUnionRectWithRegion, 
XUnionRegion, XXorRegion. 
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Name 
XSync — flush the request buffer and wait for all events and errors to be processed by the 
server. 
Synopsis 


XSync (display, discard) 
Display *display; 
int discard; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
discard Specifies: whether XSync discards all events on the input queue. This argu- 
ment is either True or False. 
Description 


XSync flushes the request buffer, then waits until all events and errors resulting from previous 
calls have been received and processed by the X server. Events are placed on the input queue. 
The client’s XError routine is called once for each error received. 


If discard is True, XSync discards all events on the input queue (including those events that ~ 
were on the queue before XSync was called). 


XSync is sometimes used with window manipulation functions (by the window manager) to 
wait for all resulting exposure events. Very few clients need to use this function. 


Related Commands 
XFlush. 
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Name 
XSynchronize — enable or disable synchronization for debugging. 


Synopsis 
int (*XSynchronize (display, onoff) ) () 
Display *display; 
Bool, onoLe; 


Arguments ' 
display Specifies a connection to an X server; returned from XOpenDisplay. 
onoff Specifies whether to enable or disable synchronization. You can pass False 
(normal asynchronous mode) or True (enable synchronization for debug- 
ging). 


Description | 
- XSynchronize tums on or off synchronous mode for debugging. If onoff is True, it turns 
on synchronous behavior; False resets the state to normal mode. 


When events are synchronized, they are reported as they occur instead of at some later time, but 
server performance is many times slower. This can be useful for debugging complex event 
handling routines. Under UNIX, the same result can be achieved without hardcoding by setting 
the global variable Xdebug to True from within a debugger. 


XSynchronize returns the previous after function. 


For more information, see Volume One, Chapter 3, Basic Window Program. 


Related Commands 
QLength, XAllowEvents, XCheckI fEvent, XCheckMaskEvent, XCheckTyped- 
Event, XCheckTypedWindowEvent, XCheckWindowEvent, XEventsQueued, 
XGetInputFocus, XGetMotionEvents, XIfEvent, XMaskEvent, XNextEvent, 
XPeekEvent, XPeekI fEvent, XPending, XPutBackEvent, XSelectInput, 
XSendEvent, XSetInputFocus, XWindowEvent. 
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Name 


XTextExtents — get string and font metrics locally. 


Synopsis 


XTextExtents (font_struct, string, nchars, direction, 
ascent, descent, overall) 
APontotruct. “font struct; 
char *string; 
Int nehazs ; 


int *direction; /* RETURN */ 
int *ascent, *descent; /* RETURN */ 
XCharStruct *overall ; /* RETURN */ 
Arguments 
font_struct Specifies a connection to an XFontStruct structure. 
string Specifies the character string for which metrics are to be returned. 
nchars Specifies the number of characters in the character string. 


direction Returns the value of the direction element of the XFontStruct. Either 
FontRightToLeft or FontLeftToRight. 


ascent Returns the font ascent element of the XFontStruct. This is the overall 
maximum ascent for the font. 


descent Returns the font descent element of the XFontStruct. This is the overall 
maximum descent for the font. 


overall Returns the overall characteristics of the string. These are the sum of the 
width measurements for each character, the maximum ascent and 
descent, the minimum lbearing added to the width of all characters up 
to the character with the smallest lbearing, and the maximum rbearing 
added to the width of all characters up to the character with the largest 
rbearing. 


Description 
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XTextExtents returns the dimensions in pixels that specify the bounding box of the speci- 
fied string of characters in the named font, and the maximum ascent and descent for the entire 
font. This function performs the size computation locally and, thereby, avoids the roundtrip 
overhead of XQueryTextExtents, but it requires a filled XFontStruct. 


ascent and descent return information about the font, while overa11 returns information 
about the given string. The returned ascent and descent should usually be used to calcu- 
late the line spacing, while the width, rbearing, and lbearing members of overall 
should be used for horizontal measures. The total height of the bounding rectangle, good for 
any string in this font, is ascent + descent. 


overall.ascent is the maximum of the ascent metrics of all characters in the string. The 
overall.descent is the maximum of the descent metrics. The overall.width is the 
sum of the character-width metrics of all characters in the string. The overall. lbearing 
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is the lbearing of the character in the. string with the smallest lbearing plus the width of 
all the characters up to but not including that character. The overall. rbearing is the 
rbearing of the character in the string with the largest rbearing plus the width of all the 
characters up to but not including that character. 


For more information on drawing text, see Volume One, Chapter 6, Drawing Graphics and 


Text. 
Structures 
typedef struct { %. 
XExtData *ext data; /* hook for extension to hang data */ 
Bont  £id; /* Lont ID! for “ehis font %</- 
unsigned direction; /* hint about direction the font is painted */ 


unsigned min char or byte2;/* first character */ 
unsigned max_char or byte2;/* last character */ 


unsigned min_bytel; /* first row that exists */ 

unsigned max_bytel; /* last row that exists */ 

Bool all chars exist; /* flag if all characters have nonzero size*/ 
unsigned default char; /* char to print for undefined character */ 

in’ naproperties, /* how many properties there are */ 

XFontProp *properties; /* pointer to array of additional properties*/ 
XCharStruct min_bounds; /* minimum bounds over all existing char*/ 
XCharStruct max_bounds; /* minimum bounds over all existing char*/ 
XCharStruct *per char; P= EPEStrChArE COs laste char ambormati ones /, 

int ascent; /* logical extent above baseline for spacing */ 
int descent; /* logical descent below baseline for spacing */ 


} XFontStruct; 


typedef struct { 


short lbearing; /* origin to left edge of character */ 
short rbearing; /* origin to right edge of character */ 
short width; /* advance to next char’s origin */ 

short ascent; /* baseline to top edge of character */ 
short descent; /* baseline to bottom edge of character */ 


unsigned short attributes; /* per char flags (not predefined) */ 
} XCharStructs 


Related Commands 
XDrawImageString, XDrawImageStringl6, XDrawString, XDrawStringl6, 
XDrawText, XDrawText16, XQueryTextExtents, XQueryTextExtents16, 
XTextExtents16, XTextWidth, XTextWidth16. 
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Name 
XTextExtents16 — get string and font metrics of a 16-bit character string, locally. 


Synopsis 
XTextExtentsl6 (font_struct, string, nchars, direction, 
ascent, descent, overall) 
XFontStruct *font_struct; 
XChazn2b *string; 
init eaGharss ; 


int *direction; /* RETURN */ 
int *ascent, *descent; /* RETURN */ 
XCharStruct *overall; /* RETURN */ 
Arguments 
font_struct Specifies a connection to an XFontStruct structure. 
string Specifies the character string made up of XChar26 structures. 
nchars Specifies the number of characters in the character string. 


direction Returns the value of the direction element of the XFontStruct. Font- 
RightToLeft of FontLeftToRight. 


ascent Returns the font ascent element of the XFontStruct. This is the overall 
maximum ascent for the font. 


descent Returns the font descent element of the XFontStruct. This is the overall 
maximum descent for the font. 


overall Returns the overall characteristics of the string. These are the sum of the 
width measurements for each character, the maximum ascent and 
descent, the minimum lbearing added to the width of all characters up 
to the character with the smallest lbearing, and the maximum rbearing 
added to the width of all characters up to the character with the largest 
rbearing. 


Description 
XTextExtents16 returns the dimensions in pixels that specify the bounding box of the 
specified string of characters in the named font, and the maximum ascent and descent for the 
entire font. This function performs the size computation locally and, thereby, avoids the 
roundtrip overhead of XQueryTextExtents16, but it requires a filled XFontStruct. 


ascent and descent return information about the font, while overall returns information 
about the given string. The returned ascent and descent should usually be used to calcu- 
late the line spacing, while the width, rbearing, and lbearing members of overall 
should be used for horizontal measures. The total height of the bounding rectangle, good for 
any string in this font, is ascent + descent. 


overall.ascent is the maximum of the ascent metrics of all characters in the string. The 
overall.descent is the maximum of the descent metrics. The overall.width is the 
sum of the character-width metrics of all characters in the string. The overall. lbearing 
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is the lbearing of the character in the string with the smallest 1bearing plus the width of 
all the characters up to but not including that character. The overall. rbearing is the 
rbearing of the character in the string with the largest rbearing plus the width of all the 
characters up to but not including that character. 


For more information on drawing text, see Volume One, Chapter 6, Drawing Graphics and 


Text. 


Structures 


typedef struct { 


short lbe 
short rbe 
short wid 
short asc 
short des 
unsigned 
} XCharStruct; 


aring; /* 
aring; jes 
th /* 
ent; /* 
cent; Le 


short attributes; /* 


typedef struct { 


XExtData *ext_data; /* 
Font fid; /* 
unsigned direction; /* 
unsigned min_char or byte2;/* 
unsigned max_char or byte2; /* 
unsigned min bytel; is 
unsigned max_bytel; /* 
Bool all chars exist; /* 
unsigned default char; le 
int n_properties; /* 
XFontProp *properties; /* 
XCharStruct min_bounds; /* 
XCharStruct max_bounds; /* 
XCharStruct *per char; /* 
int ascent; /* 
int descent; /* 


} XFontStruct; 


typedef struct { /* 
unsigned char bytel; 
unsigned char byte2; 


} XChar2b; 


Related Commands 
XDrawImageString, XDrawImageStringl6, XDrawString, XDrawStringl6, 
XDrawText, XDrawText16, XQueryTextExtents, XQueryTextExtentsl16, 
XTextExtents, XTextWidth, XTextWidth16. 
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origin to left edge of character */ 
origin to right edge of character */ 
advance to next char’s origin */ 
baseline to top edge of character */ 
baseline to bottom edge of character */ 
per char flags (not predefined) */ 


hook for extension to hang data */ 

font. ID for this -fonta%/ 

hint about direction the font is painted */ 
first character */ 

last character */ 

first row that exists */ 

last row that exists */ 

flag if all characters have nonzero size*/ 
char to print for undefined character */ 

how many properties there are */ 

pointer to array of additional properties*/ 
minimum bounds over all existing char*/ 
minimum bounds over all existing char*/ 
first char to last char information */ 
logical extent above baseline for spacing */ 
logical descent below baseline for spacing */ 


normal 16 bit characters are two bytes */ 
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Name 
XTextPropertyToStringList — obtain a list of strings from a specified XText Property struc- 
ture. 
Synopsis 


Status XTextPropertyToStringList (text_prop, list, count) 
XTextProperty *text_prop; 


Ghar ***1ist; /* RETURN */ 
ont <counc, /* RETURN */ 
Arguments 
text_prop Specifies the XText Property structure to be used. 
List Returns a list of null-terminated character strings. 
count Returns the number of strings: 
Availability 


Release 4 and later. 


Description 

XTextPropertyToStringList returns a list of strings representing the null-separated 
elements of the specified XText Property structure. The data in text_prop must be of 
type STRING and format 8. Multiple elements of the property (for example, the strings in a dis- 
joint text selection) are separated by a NULL (encoding 0). The contents of the property are not 
null-terminated. If insufficient memory is available for the list and its elements, XText- 
PropertyToStringList sets no return values and returns a zero status. Otherwise, it 
returns a non-zero status. To free the storage for the list and its contents, use XFreeSt ring- 
List. 


For more information, see Volume One, Chapter 10, Interclient Communication. 


Structures 
typedef struct { 
unsigned char *value; /* same as Property routines */ 
Atom encoding; /* prop type */ 
int format; /* prop data format: 8. 16, ome s2ec/ 
unsigned long nitems; /* number of data items in value */ 


} XTextProperty; 


Related Commands 
XFreeStringList. XGetTextProperty, XSetTextProperty, XStringListTo- 
TextProperty. 
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—Xlib — Text XTextWidth 


Name 


XTextWidth — get the width in pixels of an 8-bit character string, locally. 


Synopsis 


int “XTextWidth (font struct, ‘string, count) 
XFontStruct *font_struct; 
char *string; 
int count; 


Arguments 


font_struct Specifies the font description structure of the font in which you want to draw 


string 
count 


Description 


the string. 


Specifies the character string whose width is to be returned. 


Specifies the character count in string. 


XTextWidth returns the width in pixels of the specified string using the specified font. This 
is the sum of the XCharSt ruct .width for each character in the string. This is also equiva- 
lent to the value of overall.width returned by XQueryTextExtents or XText- 
Extents. The calculation is done assuming 8-bit font indexing. 


For more information on drawing text, see Volume One, Chapter 6, Drawing Graphics and 


Text. 


Structures 


typedef struct { 


XExtData 
Font “fiid+ 
unsigned 
unsigned 
unsigned 
unsigned 
unsigned 
Bool all 


unsigned 


int n_pro 
XFontProp 
XCharStru 
XCharStru 
XCharStru 
int ascen 
int desce 
} XFontStruct; 


*ext_data; BS 
/* 

direction; A 
Mun char Loumbyte2,1/* 
max char or byte2;/* 
min_bytel; is® 
max_bytel; /* 
chars exist; nn 
default char; Le 
perties; Ae 
*properties; fiX 
ct min_bounds; Us 
ct max_bounds; ix 
eta xperuchar; id 


iy Ak 
nt; £X 


Related Commands 
XDrawImageString, XDrawImageStringl6, XDrawString, XDrawStringl16, 
XDrawText, XDrawText16, XQueryTextExtents, XQueryTextExtents16, 
XTextExtents, XTextExtents16, XTextWidthlé. 
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hook for extension to hang data */ 

LonEgiD for this fontir/ 

hint about direction the font is painted */ 
first character */ 

last character */ 

first row that exists */ 

last row that exists */ 

flag if all characters have nonzero size*/ 
char to print for undefined character */ 

how many properties there are */ 

pointer to array of additional properties*/ 
minimum bounds over all existing char*/ 
minimum bounds over all existing char*/ 
first char to last_char information */ 
logical extent above baseline for spacing */ 
logical descent below baseline for spacing */ 
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XTextWidth16 a ee 


Name 
XTextWidth16 — get the width in pixels of a 16-bit character string, locally. 


Synopsis 
int XTextWidthl16 (font_struct, string, count) 
XFontStruct *font_struct; 
XChar2b *string; 
int count; 


Arguments 
font_struct Specifies the font description structure of the font in which you want to draw 
the string. 
string Specifies a character string made up of XChar2b structures. 
count Specifies the character count in st ring. 
Description ; 


XTextWidth16 returns the width in pixels of the specified string using the specified font. 
This is the sum of the XCharStruct.width for each character in the string. This is also 
equivalent to the value of overall.width returned by XQueryTextExtents16 or 
XTextExtents16. 


The calculation is done assuming 16-bit font indexing. 


For more information on drawing text, see Volume One, Chapter 6, Drawing Graphics and 


Text. 
Structures 
typedef struct { 
XExtData *ext_data; /* hook for extension to hang data */ 
Font fid; /**°fontelD for this font 2%/ 
unsigned direction; /* hint about direction the font is painted */ 


unsigned min_char or byte2; /* first character */ 
unsigned max_char or byte2; /* last character */ 


unsigned min_bytel; /* first row that exists */ 

unsigned max_bytel; /* last row that exists */ 

Bool all chars exist; /* flag if all characters have nonzero size*/ 
unsigned default_char; /* char to print for undefined character */ 

int n_properties; /* how many properties there are */ 

XFontProp *properties; /* pointer to array of additional properties*/ 
XCharStruct min_bounds; /* minimum bounds over all existing char*/ 
XCharStruct max_bounds; /* minimum bounds over all existing char*/ 
XCharStruct *per_ char; /* first_char to last_char information */ 

int ascent; /* logical extent above baseline for spacing */ 
int descent; /* logical descent below baseline for spacing */ 


} XFontStruct; 


Related Commands 
XDrawImageString, XDrawImageString16, XDrawSt ring, XDrawStringl16, 
XDrawText, XDrawText16, XQueryTextExtents, XQueryTextExtents16, 
XTextExtents, XTextExtents16, XTextWidth. 
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ik Mariah dneaSeomctsy J XTranslateCoordinates 


Name 
XTranslateCoordinates — change the coordinate system from one window to another. 


Synopsis 
Bool XTranslateCoordinates (display, src_w, frame_w, S©rc_x, 
Src_y, new_x, new_y, child) 
Display *display; 
Window src_w, frame_w; 
int Ssreux,; sreoy; 


int *new_x, *new_y; {* RETURN, */ 
Window *child; /* RETURN */ 
Arguments 


display Specifies a connection to an X server; returned from XOpénDisplay. 
SIC _W Specifies the ID of the source window. 


frame_w Specifies the ID of the frame of reference window. 


src_x _ Specify the x and y coordinates within the source window. 

sre_y 

new_x Return the translated x and y coordinates within the frame of reference window. 
new_y 

child If the point is contained in a mapped child of the destination window, then that 


child ID is returned in child. 


Description 
XTranslateCoordinates translates coordinates from the frame of reference of one win- 
dow to another. 


XTranslateCoordinates retumms False and *new_x and *new_y are set to zero if 
src_wand frame_ware on different screens. In addition, if the coordinates are contained in 
a mapped child of frame_w, then that child is returned in the childargument. When src_w 
and frame_y are on the same screen, XTranslateCoordinates retums True, sets 
*new_x and *new_y to the location of the point relative to frame_w, and sets child to 
None. 


This should be avoided in most applications since it requires a roundtrip request to the server. 
Most applications benefit from the window-based coordinate system anyway and don’t need 
global coordinates. Window managers often need to perform a coordinate transformation from 
the coordinate space of one window to another, or unambiguously determine which subwindow 
a coordinate lies in. XTranslateCoordinates fulfills this need, while avoiding any race 
conditions by asking the server to perform this operation. 


Errors 
BadWindow 


Related Commands 
XGeomet ry, XParseGeometry. 
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XUndefineCursor \ Vibes Cursors 


Name 
XUndefineCursor — disassociate a cursor from a window. 
Synopsis 
XUndefineCursor (display, w) 
Display *display; 
Window w; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
w Specifies the ID of the window whose cursor is to be undefined. 
Description 


XUndefineCursor sets the cursor attribute for a window to its parent’s cursor, undoing the 
effect of a previous XDefineCursor for this window. On the root window the default cursor 
is restored. 


Errors 
BadWindow 


Related Commands 
XCreateFontCursor, XCreateGlyphCursor, XCreatePixmapCursor, XDefine- 
Cursor, XFreeCursor, XQueryBestCursor, XQueryBestSize, XRecolor- 
Cursor. 
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—Xlib = Grabbing XUngrabButton 


Name 
XUngrabButton — release a button from a passive grab. 
Synopsis 
XUngrabButton (display, button, modifiers, w) 
Display *display; 
unsigned int button; 
unsigned int modifiers; 
Window w; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
button Specifies the mouse button to be released from grab. Specify Button1, 


Button2, Button3, Button4, ButtonS, or the constant AnyButton, 
which is equivalent to issuing the ungrab request for all possible buttons. 


modifiers Specifies a set of keymasks. This is a bitwise OR of one or more of the fol- 
lowing symbols: ShiftMask, LockMask, ControlMask, Mod1Mask, 
Mod2Mask, Mod3Mask, Mod4Mask, Mod5Mask, or AnyModifier. 
AnyModifier is equivalent to issuing the ungrab button request for all pos- 
sible modifier combinations (including no modifiers). 


w Specifies the ID of the window you want to release the button grab. 


Description 
XUngrabButton cancels the passive grab on a button/key combination on the specified win- 
dow if it was grabbed by this client. A modifiers of AnyModifier is equivalent to issu- 
ing the ungrab request for all possible modifier combinations (including the combination of no 
modifiers). A button of AnyButton is equivalent to issuing the request for all possible but- 
tons. This call has no effect on an active grab. 


For more information, see Volume One, Chapter 9, The Keyboard and Pointer. 
Errors 
BadWindow 
BadValue Invalid button or modifiers mask. 
Related Commands 
XChangeActivePointerGrab, XGrabButton, XGrabKey, XGrabKeyboard, 


XGrabPointer, XGrabServer, XUngrabKey, XUngrabKeyboard, XUngrab- 
Pointer, XUngrabServer. 
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XU ngrabKey Xlib - Grabbing — 


Name 
XUngrabKey — release a key from a passive grab. 


Synopsis 
XUngrabKey (display, keycode, modifiers, w) 
Display *display; 
int keycode; 
unsigned int modifiers; 
Window w; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
keycode Specifies the keycode. This keycode maps to the specific key you want to 


ungrab. Pass either a keycode or AnyKey. 


modifiers Specifies a set of keymasks. This is a bitwise OR of one or more of the fol- 
lowing symbols: ShiftMask, LockMask, ControlMask, Mod1Mask, 
Mod2Mask, Mod3Mask, Mod4Mask, Mod5Mask, or AnyModifier. 
AnyModifier is equivalent to issuing the ungrab key request for all pos- 
sible modifier combinations (including no modifiers). 


w Specifies the ID of the window for which you want to ungrab the specified 
keys. 


Description 
XUngrabKey cancels the passive grab on the key combination on the specified window if it 
was grabbed by this client. A modifiers of AnyModifier is equivalent to issuing the 
request for all possible modifier combinations (including the combination of no modifiers). A 
keycode of AnyKey is equivalent to issuing the request for all possible nonmodifier key 
codes. This call has no effect on an active grab. 


For more information, see Volume One, Chapter 9, The Keyboard and Pointer. 


Errors 
BadWindow 
BadValue Invalid keycode or modifiers mask. 


Related Commands 
XChangeActivePointerGrab, XGrabButton, XGrabKey, XGrabKeyboard, 
XGrabPointer, XGrabServer, XUngrabButton, XUngrabKeyboard, XUngrab- 
Pointer, XUngrabServer. 
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—Xlib — Grabbing XUngrabKeyboard 


Name : 
XUngrabKeyboard — release the keyboard from an active grab. 
Synopsis 
XUngrabKeyboard (display, time) 
Display *display; 
Time time; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
time Specifies the time. Pass either a timestamp, expressed in milliseconds, or the 


constant CurrentTime. If this time is earlier than the last-keyboard-grab 
time or later than the current server time, the keyboard will not be ungrabbed. 


Description 
XUngrabKeyboard releases any active grab on the keyboard by this client. It executes as 
follows: 


° Releases the keyboard and any queued events if this client has it actively grabbed from 
either XGrabKeyboard or XGrabKey. 


° Does not release the keyboard and any queued events if time is earlier than the last-key- 
board-grab time or is later than the current X server time. 


e Generates FocusIn and FocusOut events. 


The X server automatically performs an UngrabKeyboard if the grab_window (argument 
to XGrabkey and XGrabkeyboard) that becomes unviewable. 


For more information, see Volume One, Chapter 9, The Keyboard and Pointer. 
Related Commands 
XChangeActivePointerGrab, XGrabButton, XGrabKey, XGrabKeyboard, 


XGrabPointer, XGrabServer, XUngrabButton, XUngrabKey, XUngrabPointer, 
XUngrabServer. 
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XUngrabPointer \ Xlib — Pointer— 


Name 
XUngrabPointer — release the pointer from an active grab. 


Synopsis 
XUngrabPointer (display, time) 
Display *display; 
Time time; 


Arguments 
display Specifies a connection to an X server; retumed from XOpenDisplay. 
time Specifies the time when the grab should take place. Pass either a timestamp, 
expressed in milliseconds, or the constant CurrentTime. If this time is 
earlier than the last-pointer-grab time or later than current server time, the 
pointer will not be grabbed. 
Description 
XUngrabPointer releases an active grab on the pointer by the calling client. It executes as 
follows: 


° Releases the pointer and any queued events, if this client has actively grabbed the pointer 
from XGrabPointer, XGrabButton, or from a normal button press. 


° Does not release the pointer if the specified time is earlier than the last-pointer-grab time 
or is later than the current X server time. 


° Generates EnterNotify and LeaveNotify events. 


The X server performs an XUngrabPointer automatically if the event_window or 
confine_to window (arguments of XGrabButton and XGrabPointer) becomes not 
viewable, or if the confine_to window is moved, completely outside the root window. 


For more information, see Volume One, Chapter 9, The Keyboard and Pointer. 
Related Commands 
XChangeActivePointerGrab, XChangePointerControl, XGetPointer- 


Control, XGetPointerMapping, XGrabPointer, XQueryPointer, XSet- 
PointerMapping, XWarpPointer. 
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—Xlib - Grabbing ) XUngrabServer 


Name 
XUngrabServer — release the server from grab. 
Synopsis 
XUngrabServer (display) 
Display *display; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 


Description 
XUngrabServer releases the grabbed server, and begins execution of all the requests queued 
during the grab. XUngrabServer is called automatically when a client-closes its connection. 


For more information, see Volume One, Chapter 9, The Keyboard and Pointer. 


Related Commands 


XChangeActivePointerGrab, XGrabButton, XGrabKey, XGrabKeyboard, 
XGrabPointer, XGrabServer, XUngrabButton, XUngrabKey, XUngrab- 
Keyboard, XUngrabPointer, 
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XUninstallColormap Xilb - Colormaps— 


Name 
XUninstallColormap — uninstall a colormap; install default if not already installed. 


Synopsis 
XUninstallColormap (display, cmap) 
Display *display; 
Colormap cmap; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
cmap Specifies the colormap to be uninstalled. 

Description 


If cmap is an installed map for its screen, it is uninstalled. If the screen’s default colormap is 
not installed, it is installed. : 


If cmap is an installed map, a ColormapNotify event is generated on every window having 
this colormap as an attribute. If a colormap is installed as a result of the uninstall, a 
ColormapNotify event is generated on every window having that colormap as an attribute. 


At any time, there is a subset of the installed colormaps, viewed as an ordered list, called the 
required list. The length of the required list is at most the min_maps specified for each screen 
in the Display structure. When a colormap is installed with XInstallColormap it is 
added to the head of the required list and the last colormap in the list is removed if necessary to 
keep the length of the list at min_maps. When a colormap is uninstalled with XUninstall- 
Colormap and it is in the required list, it is removed from the list. No other actions by the 
server or the client change the required list. It is important to realize that on all but high-per- 
formance workstations, min_maps is likely to be one. 


For more information on installing and uninstalling colormaps, see Volume One, Chapter 7, 
Color. 


Errors 
BadColormap 


Related Commands 
DefaultColormap, DisplayCells, XCopyColormapAndF ree, XCreate- 
Colormap, XFreeColormap, XGetStandardColormap, XInstallColormap, 
XListInstalledColormaps, XSetStandardColormap, XSetWindowColormap. 
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uy ReSburde! Manager ) XUnionRectWithRegion 


Name ‘ 
XUnionRectWithRegion — add a rectangle to a region. 


Synopsis 
XUnionRectWithRegion (rectangle, src_region, dest_region) 
XRectangle *rectangle; 
Region src_region; 
Region dest_region; 


Arguments 
rectangle Specifies the rectangle to add to the region. 


src_region Specifies the source region to be used. 


dest_region Specifies the resulting region. May be the same as src_ region. 


Description 
XUnionRectWithRegion computes the destination region from a union of the specified 
rectangle and the specified source region. The source and destination regions may be the same. 


One common application of this function is to simplify the combining of the rectangles speci- 
fied in contiguous Expose events into a clip mask in the GC, thus restricting the redrawn 
areas to the exposed rectangles. Use XUnionRectWithRegion to combine the rectangle in 
each Expose event into a region, then call XSetRegion. XSetRegion sets the 
clip mask inaGC to the region. In this case, src_regionand dest_ region would be 
the same region. 


If src_region and dest_region are not the same region, src_region is copied to 
dest_region before the rectangle is added to dest_ region. 


For more information on regions, see Volume One, Chapter 6, Drawing Graphics and Text. 


Structures 
typedef struct { 
Snont..x%;- V7. 
unsigned short width, height; 
} XRectangle; 


Region is a pointer to an opaque data type. 
Related Commands 
XClipBox, XDest royRegion, XEmptyRegion, XEqualRegion, XIntersect- 


Region, XOffsetRegion, XPointInRegion, XPolygonRegion, XRectInRegion, 
XSetRegion, XShrinkRegion, XSubtractRegion, XUnionRegion, XXorRegion. 
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XUnionRegion Xlib — Regions— 


Name 
XUnionRegion — compute the union of two regions. 
Synopsis 
XUnionRegion(sra, srb, dr) 
Region sra, srb; 
Region dr; 


Arguments 
sra Specify the two regions in which you want to perform the computation. 
Srb 
dr Returns the result of the computation. 

Description 


XUnionRegion computes the union of two regions and places the result in dr. The resulting 
region will contain all the area of both the source regions. 


For more information on regions, see Volume One, Chapter 6, Drawing Graphics and Text. 


Structures 
Region is a pointer to an opaque structure type. 


Related Commands 
XClipBox, XCreateRegion, XDest royRegion, XEmptyRegion, XEqualRegion, 
XIntersectRegion, XOffsetRegion, XPointInRegion, XPolygonRegion, 
XRect InRegion, XSetRegion, XShrinkRegion, XSubt ractRegion, XUnion- 
RectWithRegion, XXorRegion. 
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— Xlib — Context Manager —————— XUniqueContext 


Name 
XUniqueContext — create a new context ID (not graphics context). 


Synopsis 
XContext XUniqueContext () 


Description 
The context manager allows association of arbitrary data with a resource ID. This call creates a 
unique ID that can be used in subsequent calls to XFindContext, XDeleteContext, and 
XSaveContext. 


For more information on the context manager, see Volume One, Chapter 13, Other Program- 
ming Techniques. 


Structures 
typedef int XContext; 


Related Commands 
XDeleteContext, XFindContext, XSaveContext. 
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XUnloadFont Xlib — Fonts— 


Name 
XUnloadFont — unload a font. 
Synopsis 
XUnloadFont (display, font) 
Display *display; 
Font font; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
font Specifies the ID of the font to be unloaded. 

Description | 


XUnloadFont indicates to the server that this client no longer needs the specified font. The 
font may be unloaded on the X server if this is the last client that needs the font. In any case, 
the font should never again be referenced by this client because Xlib destroys the resource ID. 


For more information on loading and unloading fonts, see Volume One, Chapter 6, Drawing 
Graphics and Text. 


Errors 
BadFont 


Related Commands 
XCreateFontCursor, XFreeFont, XFreeFontInfo, XFreeFontNames, XFree- 
FontPath, XGetFontPath, XGetFontProperty, XListFonts, XListFontswith- 
Info, XLoadFont, XLoadQueryFont, XQueryFont, XSetFont, XSetFontPath. 
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—Xlib Mapping ) XUnmapSubwindows 


Name ‘ 
XUnmapSubwindows — unmap all subwindows of a given window. 
Synopsis 
XUnmapSubwindows (display, w) 
Display *display; 


Window w; 
Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
Ww Specifies the ID of the window whose subwindows are to be unmapped. 
Description 


XUnmapSubwindows performs an XUnmapWindow on all mapped children of w, in bottom 
to top stacking order. (It does not unmap subwindows of subwindows.) 


XUnmapSubwindows also generates an UnmapNotify event on each subwindow and gen- 
erates exposure events on formerly obscured windows. This is much more efficient than 
unmapping many subwindows one at a time, since much of the work need only be performed 
once for all of the subwindows rather than for each subwindow. 


For more information on window mapping, see Volume One, Chapter 2, X Concepts. 


Errors 
BadWindow 


Related Commands 
XMapRaised, XMapSubwindows, XMapWindow, XUnmapWindow. 
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XUnmapWindow Xlib - Mapping — 


Name 
XUnmap Window — unmap a window. 


Synopsis 
XUnmapWindow (display, w) 
Display *display; 
Window w; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
w Specifies the window ID. 

Description 


XUnmapWindow removes w and all its descendants from the screen (but does not unmap the 
descendents). If w is already unmapped, XUnmapWindow has no effect. Otherwise, w is 
unmapped and an UnmapNotify event is generated. Normal exposure processing on for- 
merly obscured windows is performed. 


Descendants of w will not be visible until w is mapped again. In other words, the subwindows 
are still mapped, but are not visible because w is unmapped. Unmapping a window will gener- 
ate exposure events on windows that were formerly obscured by w. 


For more information on window mapping, see Volume One, Chapter 2, X Concepts. 


Errors 
BadWindow 


Related Commands 
XMapRaised, XMapSubwindows, XMapWindow, XUnmapSubwindows. 
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—Xiib - Window Manager Hints ——7 XVisuallDFromVisual 


Name i 
XVisualIDFromVisual — obtain the visual ID from a Visual. 


Synopsis 
VisualID XVisualIDFromVisual (visual) 
Visual *visual; 


Arguments 
visual Specifies the visual type. 


Description 


XVisualIDFromVisual returns the visual ID for the specified visual. This is needed when 
filling an XVisualiInfo structure template before calling XGet VisualInfo. 


For more information, see Volume One, Chapter 10, /nterclient Communication. 


Related Commands 
XGetVisuallinfo. 
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XWMGeometry Xlib — Window Manager Hints— 


Name 


XWMGeometry — obtain a window’s geometry information. 


Synopsis 
int XWMGeometry (display, screen, user_geom, def_geom, bwidth, 


hints, x, y, width, height, gravity) 
Display *display; 
int screen; 
char *user_geom; 
char *def_geom; 
unsigned int bwidth; 
XSizeHints *hints; 
ari e or Vr /* RETURN */ 
int *width, *height; /* RETURN */ 
int *gravity; /* RETURN */ 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 


screen Specifies the screen. 


user_geom Specifies the user-specified geometry or NULL. 


def_geom Specifies the application’s default geometry or NULL. 


bwidth Specifies the border width. 
hints Specifies the size hints for the window in its normal state. 
x 
y Return the x and y offsets. 
width 
height Return the width and height determined. 
gravity Returns the window gravity. 
Availability 


Release 4 and later. 


Description 
XWMGeomet ry combines possibly incomplete or nonexistent geometry information (given in 
the format used by XParseGeomet ry) specified by the user and by the calling program with 
complete program-supplied default size hints (usually the ones to be stored in 
WM NORMAL HINTS) and returns the position, size, and gravity (NorthWestGravity, 


NorthEastGravity, SouthEastGravity or SouthWestGravity) that describe the 
window. If the base size is not set in the XSizeHints structure, the minimum size is used if 
set. Otherwise, a base size of zero is assumed. If no minimum size is set in the hints structure, 
the base size is used. A mask (in the form returned by XParseGeomet ry) that describes 


538 


Xlib Reference Manual 


Xlib — Window Manager Hints (continued) XWMGeometry 


which values came from the user and whether or not the position coordinates are relative to the 
right and bottom edges is returned (which will have already been accounted for in the x and y 
values). 


Note that invalid user geometry specifications can cause a width or height of zero to be 
returned. The caller may pass the address of the win_gravity field of the hints argument 
as the gravity argument. 


For more information, see Volume One, Chapter 10, Jnterclient Communication. 


Structures 
typedef struct { 
long flags; /* marks whitch) fields tin this structure gare 
/* defined */ 
dint Axe Ver /* obsolete for new window mgrs, but clients */ 


int width, height; /* should set. so old wm’s don’t mess up */ 
int min_width, min_height; 
int max width, max_height; 
int width ane, heighten? 
struct 4 
intexs! /*onumerator Gi/ 
int y; /* denominator */ 
} min_aspect, max_aspect; 
int base width, base height; /* added by. I€CCM-version 1 */ 
int win_gravity; /* added by ICCCM version 1 */ 
} XSizeHints 


Related Commands 
XChangeWindowAttributes, XParseGeometry, XSetWMProperties. 
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XWarpPointer Xlib — Pointer— 


Name 
XWarpPointer — move the pointer to another point on the screen. 


Synopsis 
XWarpPointer (display, src_w, dest_w, sSrc_X, SIrc_y, 
src_width, src_height, dest_x, dest_y) 
Display *display; 
Window src_w, dest_w; 
ant Src xX, Src -y; 
unsigned int src_width, src_height; 
int dest_x, dest_y; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
SEC Ww. Specifies the ID of the source window. You can also pass None. 
dest_w Specifies the ID of the destination window. You can also pass None. 
SIC. Specify the x and y coordinates within the source window. These are used 
Srey with src_width and src_height to determine the rectangle - the 
pointer must be in order to be moved. They are not the present pointer posi- 
tion. If src_y is None, these coordinates are relative to the root window 
of src_w. 
src_width Specify the width and height in pixels of the source area. Used with src_x 
sxrc_height and src_y. 
dest_x Specify the destination x and y coordinates within the destination window. 
dest_y If dest_y is None, these coordinates are relative to the root window of 
dest_w. 
Description 


XWarpPointer moves the pointer suddenly from one point on the screen to another. 


If dest_wis a window, XWarpPointer moves the pointer to [dest_x, dest_y] relative to 
the destination window’s origin. If dest_w is None, XWarpPointer moves the pointer 
according to the offsets [dest_x, dest_y] relative to the current position of the pointer. 


If src_window is None, the move is independent of the current cursor position (dest_x and 
dest_y use global coordinates). If the source window is not None, the move only takes place 
if the pointer is currently contained in a visible portion of the rectangle of the source window 
(including its inferiors) specified by src_x, src_y, src_width and src_height. If 
src_width is zero (0), the pointer must be between src_x and the right edge of the window 
to be moved. If src_height is zero (0), the pointer must be between src_y and the bottom 
edge of the window to be moved. 


XWarpPointer cannot be used to move the pointer outside the confine_to window of an 
active pointer grab. If this is attempted the pointer will be moved to the point on the border of 
the confine_to window nearest the requested destination. 


540 Xlib Reference Manual 


Xlib — Pointer (continued) XWarpPointer 


XWarpPointer generates events as if the user had (instantaneously) moved the pointer. 


This function should not be used unless absolutely necessary, and then only in tightly con- 
trolled, predictable situations. It has the potential to confuse the user. 


Errors 
BadWindow 


Related Commands 
XChangeActivePointerGrab, XChangePointerControl, XGetPointer- 
Control, XGetPointerMapping, XGrabPointer, XQueryPointer, XSet- 
PointerMapping, XUngrabPointer. 
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XWindowE vent Xlib — Input Handling— 


Name 
XWindowEvent — remove the next event that matches the specified mask and window. 


Synopsis 
XWindowEvent (display, w, event_mask, rep) 
Display *display; 
Window w; 
long event_mask; 


XEvent *rep; /* RETURN */ 
Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
w Specifies the ID of the window whose next matching event you want. 
event_mask Specifies the event mask. See xXSelectInput for a complete list of event 
masks. 
rep Returns the event removed from the input queue. 


Description 
XWindowEvent removes the next event in the queue which matches both the passed window 
and the passed mask. The event is copied into an XEvent structure supplied by the caller. 
Other events in the queue are not discarded. If no such event has been queued, XWindow- 
Event flushes the request buffer and waits until one is received. 


Structures 
See individual event structures described in Volume One, Chapter 8, Events, and Appendix F, 
Structure Reference in this volume. 


Related Commands 
QLength, XAllowEvents, XCheckIfEvent, XCheckMaskEvent, XCheckTyped- 
Event, XCheckTypedWindowEvent, XCheckWindowEvent, XEventsQueued, 
XGetInputFocus, XGetMotionEvents, XIfEvent, XMaskEvent, XNextEvent, 
XPeekEvent, XPeekI fEvent, XPending, XPutBackEvent, XSelectInput, 
XSendEvent, XSetInputFocus, XSynchronize. 
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—Xiib - Window Manager Hints ——7 XWithdrawWindow 


Name ’ 
X Withdraw Window — request that a top-level window be withdrawn. 


Synopsis 
Status XWithdrawWindow (display, w, screen_number) 
Display *display; 
Window w; 
int screen_number; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
Ww Specifies the window. 


screen_number 
Specifies the appropriate screen number on the server. 


Availability 
Release 4 and later. 


Description 

XWithdrawWindow informs the window manager that the specified window and its icon 
should be unmapped. It unmaps the specified window and sends a synthetic UnmapNotify 
event to the root window of the specified screen. Window managers may elect to receive this 
message and may treat it as a request to change the window’s state to withdrawn. When a win- 
dow is in the withdrawn state, neither its normal nor its iconic representation is visible. 
XWithdrawWindow retums a nonzero status if the UnmapNotify event is successfully sent; 
otherwise, it returns a zero status. 


For more information, see Volume One, Chapter 10, Interclient Communication. 


Errors 
BadWindow 


Related Commands 
XIconifyWindow, XReconfigureWindow. 
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XWr iteBitmapFile Xlib — Pixmaps and Tiles— 


Name 
XWriteBitmapFile — write a bitmap to a file. 


Synopsis 
int XWriteBitmapFile(display, filename, bitmap, width, 
height, x_hot, y_hot) 

Display *display; 

char *filename; 

Pixmap bitmap; 

unsigned int width, height; 

int % hot, y.hot; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
filename Specifies the filename to use. The format of the filename is operating system 
specific. 
bitmap Specifies the bitmap to be written. 
width Specify the width and height in pixels of the bitmap to be written. 
height 
DOL Specify where to place the hotspot coordinates (or —1,-1 if none present) in 
WO the file. 
Description 


XWriteBitmapFile writes a bitmap to a file. The file is written out in X version 11 bitmap 
file format, shown below. 


If the file cannot be opened for writing, XWriteBitmapFile returns BitmapOpen- 
Failed. If insufficient memory is allocated XWriteBitmapFile returns Bitmap- 
NoMemory. Otherwise, on no error, XWriteBitmapFile returns BitmapSuccess. 


If x_hot and y_hot are not -1, —1, then XWriteBitmapFile writes them out as the 
hotspot coordinates for the bitmap. 


The following is an example of the contents of a bitmap file created. The name used (“gray” in 
this example) is the portion of filename after the last “/’. 


#define gray width 16 

#define gray height 16 

#define gray x hot 8 

#define gray y hot 8 

static char gray bits[] = { 
Oxi8,, Oxlt, Oxe3, Oxc?, Oxecf, Oxf3, 0x9f, Oxto, Oxbr, Oxtdy Oxoan Oxcce 
Ox7f, Oxfe, Ox7f, Oxfe, Ox7e, Ox7e, Ox7f, Oxfe, 0x37, Oxec, Oxbb, Oxdd, 
Ox9G,, 0x39, Oxch,, Oxt3i,, OxeS, Oxe7, OR£8,) Osetia 


For more information on bitmaps, see Volume One, Chapter 6, Drawing Graphics and Text. 
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Xlib — Pixmaps and Tiles (continued) XWriteBitmapFile 


Errors 
BadAlloc 


BadDrawable 


BadMatch The specified width and height did not match dimensions of the specified 
bitmap. 


Related Commands 
XCreateBitmapFromData, XCreatePixmap, XCreatePixmapFromBitmapData, 
XFreePixmap, XQueryBest Size, XQueryBestStipple, XQueryBestTile, 
XReadBitmapFile, XSetTile, XSetWindowBackgroundPixmap, XSetWindow- 
BorderPixmap. 


Xlib Reference Manual : 545 


XXorRegion Xlib — Regions— 


Name 
XXorRegion — calculate the difference between the union and intersection of two regions. 
Synopsis 
XXorRegion(sra, srb, dr) 
Region sra, srb; 


Region dr; /* RETURN */ 
Arguments 
sra Specify the two regions on which you want to perform the computation. 
srb 
ar Returns the result of the computation. 
Description 


XXorRegion calculates the union minus the intersection of two regions, and places it in dr. 
Xor is short for “Exclusive OR”, meaning that a pixel is included in dr if it is set in either sra 
or srb but not in both. 


For more information on regions, see Volume One, Chapter 6, Drawing Graphics and Text. 


Structures 
Region is a pointer to an opaque structure type. 


Related Commands 
XClipBox, XCreateRegion, XDest royRegion, XEmptyRegion, XEqualRegion, 
XIntersectRegion, XOffsetRegion, XPointInRegion, XPolygonRegion, 
XRect InRegion, XSetRegion, XShrinkRegion, XSubt ractRegion, XUnion- 
RectWithRegion, XUnionRegion. 
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A.1 


A 


Function Group Summary 


This quick reference is intended to help you find and use the right function for a particular 


task. It supplies two lists: 


¢ Listing of Functions by Groups 


e Alphabetical Listing of Functions 


Both functions and macros are listed in all the groups in which they belong. Therefore, sev- 
eral of them are listed more than once. 


Remember that Xlib functions begin with the letter “X”; macros do not. 


Group Listing with Brief Descriptions 


Association Tables 


XCreateAssocTable 
XDeleteAssoc 
XDestroyAssocTable 
XLookUpAssoc 
XMakeAssoc 


Buffers 


XStoreBuffer 
XStoreBytes 
XFetchBuffer 
XFetchBytes 
XRotateBuffers 


Function Group Summary 


Create a new association table (X10). 

Delete an entry from an association table. 

Free the memory allocated for an association table. 
Obtain data from an association table. 

Create an entry in an association table. 


Store data in a cut buffer. 
Store data in cut buffer 0. 
Return data from a cut buffer. 
Return data from cut buffer 0. 
Rotate the cut buffers. 
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Client Connections 








XKillClient Destroy a client or its remaining resources. 

XSetCloseDownMode Change the close down mode of a client. 

Colorcells 

XAllocColor Allocate a read-only colormap cell with closest hardware-sup- 
ported color. 

XAllocColorCells Allocate read/write (nonshared) colorcells. 

XAllocColorPlanes Allocate read/write (nonshareable) color planes. 

XAllocNamedColor Allocate a read-only colorcell from color name. 

XLookupColor Get database RGB values and closest hardware-supported 
RGB values from color name. 

XParseColor Look up or translate RGB values from color name or hexade- 
cimal value. 

XQueryColor Obtain the RGB values for a specified pixel value. 

XQueryColors Obtain RGB values and flags for each specified pixel value. 

XStoreColor Set or change a read/write entry of a colormap to the closest 
available hardware color. 

XStoreColors Set or change read/write colorcells to the closest available 
hardware colors. 

XStoreNamedColor Allocate a read/write colorcell by English color name. 

XFreeColors Free colormap cells or planes. 

BlackPixel Return a black pixel value on the default colormap of screen. 

WhitePixel Return a pixel value representing white in default colormap. 

Colormaps 

XCopyColormapAndFree Copy a colormap and return a new colormap ID. 

XCreateColormap Create a colormap. 

XFreeColormap Delete a colormap and install the default colormap. 

XGetStandardColormap Get the standard colormap property. 

XSetStandardColormap Change the standard colormap property. 

XSetWindowColormap Set the colormap for a specified window. 

XInstallColormap Install a colormap. 

XUninstallColormap Uninstall a colormap; install default if not already installed. 


XListInstalledColormaps 
DefaultColormap 
DefaultColormapOfScreen 


Get a list of installed colormaps. 
Return the default colormap on the default screen. 
Return the default colormap on the specified screen. 





DisplayCells Return the maximum number of colormap cells on the con- 
nected display. 

Context Manager 

XDeleteContext Delete a context entry for a given window and type. 

XFindContext Get data from the context manager (not graphics context). 
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Context Manager (continued) 


XSaveContext 


XUniqueContext 


Cursors 


XDefineCursor 
XUndefineCursor 
XCreateFontCursor 
XCreateGlyphCursor 
XCreatePixmapCursor 
XFreeCursor 
XRecolorCursor 
XQueryBestCursor 
XQueryBestSize 


Display Specifications 


DefaultColormap 
DefaultDepth 
DefaultGC 


DefaultScreen 


DefaultVisual 
DisplayCells 


DisplayHeight 


DisplayHeightMM 
DisplayPlanes 
DisplayString 


DisplayWidth 
DisplayWidthMM 
RootWindow 

ScreenCount 
XDisplayMotionBufferSize 
XListDepths 
XListPixmapFormats 
XMaxRequestSize 
XResourceManagerString 


Function Group Summary 


Save a data value corresponding to a window and context type 
(not graphics context). 
Create.a new context ID (not graphics context). 


Assign a cursor to a window. 

Disassociate a cursor from a window. 

Create a cursor from the standard cursor font. 

Create a cursor from font glyphs. 

Create a cursor from two bitmaps. 

Destroy a cursor. 

Change the color of a cursor. 

Get the closest supported cursor sizes. 

Obtain the "best" supported cursor, tile, or stipple size. 


Return the default colormap on the specified screen. 

Return the depth of the default root window for a screen. 
Return the default graphics context for the root window of a 
screen. 

Return the screen integer; the last segment of a string passed to 
XOpenDisplay, or the DISPLAY environment variable if 
NULL was used. 

Return the default visual structure for a screen. 

Return the maximum number of colormap cells on the con- 
nected display. 

Return an integer that describes the height of the screen in pix- 
els. 

Return the height of the specified screen in millimeters. 

Return the number of planes on the connected display. 

Return the string that was passed to XOpenDisplay or if 
that was NULL, the DISPLAY variable. 

Return the width of the screen in pixels. 

Return the width of the specified screen in millimeters. 

Return the ID of the root window. 

Return the number of available screens. 

Return size of server’s motion history buffer. 

Return a list of the depths supported on this server. 

Return a list of the pixmap formats supported on this server. 
Return maximum request size allowed on this server. 

Return string containing user’s resource database. 
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Drawing Primitives 





XDraw 

XDrawArc 
XDrawArcs 
XDrawFilled 
XDrawLine 
XDrawLines 
XDrawPoint 
XDrawPoints 
XDrawRectangle 
XDrawRectangles 
XDrawSegments 
XCopyArea 
XCopyP lane 


XFillArc 
XFillArcs 
XFillPolygon 
XFillRectangle 
XFillRectangles 
XClearArea 
XClearWindow 


Errors 


XGetErrorDatabaseText 
XGetErrorText 
XSetErrorHandler 

XSet IOErrorHandler 
XDisplayName 
XSetAfterFunction 
XSynchronize 


Events 


XSelectInput 
XSendEvent 
XSetInputFocus 
XGet InputFocus 
XWindowEvent . 
XCheckWindowEvent 


XCheckTypedEvent 
XCheckTypedWindowEvent 


XMaskEvent 
XCheckMaskEvent 
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Draw a polyline or curve between vertex list (from X10). 
Draw an arc fitting inside a rectangle. 

Draw multiple arcs. 

Draw a filled polygon or curve from vertex list (from X10). 
Draw a line between two points. 

Draw multiple connected lines. 

Draw a point. 

Draw multiple points. 

Draw an outline of a rectangle. 

Draw the outlines of multiple rectangles. 

Draw multiple disjoint lines. 

Copy an area of a drawable. 

Copy a single plane of a drawable into a drawable with depth, 
applying pixel values. 

Fill an arc. 

Fill multiple arcs. 

Fill a polygon. 

Fill a rectangular area. 

Fill multiple rectangular areas. 

Clear a rectangular area in a window. 

Clear an entire window. 


Obtain error messages from the error database. 

Obtain a description of error code. 

Set a nonfatal error event handler. 

Handle fatal I/O errors. 

Report the display name when connection to a display fails. 
Set a function called after all Xlib functions. 

Enable or disable synchronization for debugging. 


Select the event types to be sent to a window. 

Send an event. 

Set the keyboard focus window. 

Return the current keyboard focus window. 

Remove the next event matching mask and window. 

Remove the next event matching both passed window and pas- 
sed mask; don’t wait. 

Return the next event in queue that matches event type; don’t 
wait. 

Return the next event in queue matching type and window. 
Remove the next event that matches mask. 

Remove the next event that matches mask; don’t wait. 
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Events (continued) 





XIfEvent 
XCheckI fEvent 
XPeekEvent 
XPeekIfEvent 
XAllowEvents 


XGetMotionEvents 
XNextEvent 
XPutBackEvent 
XEventsQueued 
XPending 


XSynchronize 
QLength 


Extensions 


XFreeExtensionList 
XListExtensions 
XQueryExtension 


Fonts 


XLoadFont 
XUnloadFont 
XFreeFont 
XFreeFontInfo 
XFreeFontNames 
XFreeFontPath 
XListFonts 
XListFontsWithInfo 
XQueryFont 
XSetFont 
XSetFontPath 
XGetFontPath 
XGetFontProperty 
XCreateFontCursor 


Grabbing 


XGrabKey 
XUngrabKey 
XGrabKeyboard 
XUngrabKeyboard 
XGrabButton 


Function Group Summary 


Wait for matching event. 

Check the event queue for a matching event. 

Get an event without removing it from the queue. 

Get an event without recovering it from the queue; don’t wait. 
Control the behavior of keyboard and pointer events when 
these resources are grabbed. 

Get pointer motion events. 

Get the next event of any type or window. 

Push an event back on the input queue. 

Check the number of events in the event queue. 

Flush the request buffer and return the number of pending 
input events. 

Enable or disable synchronization for debugging. 

Return the current length of the input queue on the connected 
display. 


Free memory allocated for a list of installed extensions to X. 
Return a list of all extensions to X supported by the server. 
Get extension information. 


Load a font if not already loaded; get font ID. 
Unload a font. 

Unload a font and free storage for the font structure. 
Free multiple font information arrays. 

Free the font name array. 

Free the memory allocated by XGet FontPath. 
Return a list of the available font names. 

Obtain the names and information about loaded fonts. 
Return information about a loaded font. 

Set the current font in a graphics context. 

Set the font search path. 

Get the current font search path. 

Get a font property given its atom. 

Create a cursor from the standard cursor font. 


Grab a key. 

Release a key from crab. 

Grab the keyboard. 

Release the keyboard from grab. 
Grab a pointer button. 
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Grabbing (continued) 





XUngrabButton 
XGrabPointer 
XUngrabPointer 
XGrabServer 
XUngrabServer 


XChangeActivePointerGrab 


Graphics Context 


XCreateGC 


XChangeGC 
XCopyGC 

XFreeGC 
XGContextFromGC 


XGetGCValues 
XSetArcMode 
XSetClipMask 
XSetClipOrigin 
XSetClipRectangles 
XSetRegion 


XSetDashes 


XSetLineAttributes 
XSetFillRule 
XSetFillStyle 
XSetTile 
XSetStipple 
XSetTSOrigin 
XSetGraphicsExposures 
XSetForeground 
XSetBackground 
XSetFunction 
XSetPlaneMask 
XSetState 


XSetSubwindowMode 
DefaultGC 
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Release a button from grab. 

Grab the pointer. 

Release the pointer from grab. 

Grab the server grab. 

Release the server from grab. 

Change the parameters of an active pointer grab. 


Create a new graphics context for a given screen with the 
depth of the specified drawable. 

Change the components of a given graphics context. 

Copy a graphics context. 

Free a graphics context. 

Obtain the GContext (resource ID) associated with the 
specified graphics context. 

Get GC component values from Xlib’s GC cache. 

Set the arc mode in a graphics context. 

Set clip mask pixmap in a graphics context. 

Set the clip origin in a graphics context. 

Set clip _mask ina graphics context to the list of rectangles. 
Set clip _mask of the graphics context to the specified 
region. 

Set dash_offset and dashes (for lines) in a graphics 
context. 

Set the line drawing components in a graphics context. 

Set the fill rule in a graphics context. 

Set the fill style in a graphics context. 

Set the fill tile in a graphics context. 

Set the stipple in a graphics context. 

Set the tile/stipple origin in a graphics context. 

Set graphics exposures ina graphics context. 

Set the foreground pixel value in a graphics context. 

Set the background pixel value in a graphics context. 

Set the bitwise logical operation in a graphics context. 

Set the plane mask in a graphics context. 

Set the foreground, background, logical function and plane 
mask in a graphics context. 

Set the subwindow mode in a graphics context. 

Return the default graphics context for the root window of a 
screen. 
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Host Access 


XAddHost 

XAddHosts 

XListHosts 
XRemoveHost 
XRemoveHosts 
XDisableAccessControl 
XEnableAccessControl 
XSetAccessControl 


HouseKeeping 


XFree 
XOpenDisplay 
XCloseDisplay 
XNoOp 


Images 


XCreateImage > 
XDestroyImage 
XPut Image 
XSubImage 
XGet Image 
XGetSubImage 


XAddPixel 
XPutPixel 
XGetPixel 
ImageByteOrder 


Interclient Communication 


Add a host to the access control list. 

Add multiple hosts to the access control list. 

Obtain a list of hosts having access to this display. 

Remove a host from the access control list. 

Remove multiple hosts from the access control list. 

Allow access from any host. 

Use access control list to allow or deny connection requests. 
Disable or enable access control. 


Free specified in-memory data created by an Xlib function. 
Connect a client program to an X server. 

Disconnect a client program from an X server and display. 
Send a NoOp to exercise connection with the server. 


Allocate memory for an XImage structure. 

Deallocate memory associated with an image. 

Draw a rectangular image on a window or pixmap. 

Create a subimage from part of an image. 

Place contents of a rectangle from drawable into an image. 
Copy a rectangle in drawable to a location within the pre- 
existing image. 

Add a constant value to every pixel value in an image. 

Set a pixel value in an image. 

Obtain a single pixel value from an image. 

Specify the required byte order for images for each scan line 
unit in XYFormat (bitmap) or for each pixel value in ZFor- 
mat. Returns either LSBFirst or MSBFirst. 


(see Window Manager Hints, Selections, and Cut Buffers) 


Keyboard 


XKeycodeToKeysym 
XKeysymToKeycode 
XKeysymToString 
XStringToKeysym 
XLookupKeysym 
XRebindKeysym 


Function Group Summary 


Convert a keycode to a keysym. 

Convert a keysym to the appropriate keycode. 

Convert a keysym symbol to a string. 

Convert a keysym name string to a keysym. 

Get the keysym corresponding to a keycode in a structure. 
Rebind a keysym to a string for client. 
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Keyboard (continued) 





XLookupString 


XQueryKeymap 
XGetKeyboardMapping 
XChangeKeyboardMapping 
XRefreshKeyboardMapping 
XSetModifierMapping 
XGetModifierMapping 
XDeleteModifiermapEntry 
XInsertModifiermapEntry 
XNewModifiermap 
XFreeModifiermap 
XDisplayKeycodes 


Macros, Display 


AllPlanes 
BlackPixel 
BlackPixelOfScreen 


CellsOfScreen 
ConnectionNumber 


DefaultColormap 
DefaultColormapOfScreen 
DefaultDepth 
DefaultDepthOfScreen 
DefaultGC 


DefaultGCOfScreen 
DefaultRootWindow 


DefaultScreen 


DefaultScreenOfDisplay 
DefaultVisual 
DefaultVisualOfScreen 
DisplayCells 


DisplayHeight 
DisplayHeightMM 


DisplayOfScreen 
DisplayPlanes 
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Map a key event to ASCII string, keysym, and Compose- 
Status. 

Obtain a bit vector for the current state of the keyboard. 
Return symbols for keycodes. 

Change the keyboard mapping. 

Update the stored modifier and keymap information. 

Set keycodes to be used as modifiers (Shift, Control, etc.). 
Obtain modifier key mapping (Shift, Control, etc.). 

Delete an entry from an XModifierKeymap structure. 
Add a new entry to an XModif ierKeymap Structure. 
Create a keyboard modifier mapping structure. 

Destroy and free a keyboard modifier mapping structure. 
Returns range of keycodes used by server. 


Return an unsigned long value with all bits set. 

Return a black pixel value on the default colormap of screen. 
Return the black pixel value in the default colormap of the 
specified screen. 

Return the number of colormap cells of the specified screen. 
Return the connection number (file descriptor on UNIX sys- 
tem). 

Return the default colormap on the specified screen. 

Return the default colormap of the specified screen. 

Return the depth of the default root window for a screen. 
Return the default depth of the specified screen. 

Return the default graphics context for the root window of a 
screen. 

Return the default graphics context (GC) of the specified 
screen. 

Return the root window for the default screen. 

Return the screen integer; the last segment of a string passed to 
XOpenDisplay, or the DISPLAY environment variable if 
NULL was used. 

Return the default screen of the specified display. 

Return the default visual structure for a screen. 

Return the default visual of the specified screen. 

Return the maximum number of colormap cells on the con- 
nected display. 

Return an integer that describes the height of the screen in pix- 
els. 

Return the height of the specified screen in millimeters. 

Return the display of the specified screen. 

Return the number of planes on the connected display. 
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Macros, Display (continued) 


DisplayString 
DisplayType 


DisplayWidth 
DisplayWidthMM 
DoesBackingStore 


'DoesSaveUnders 


dpyno 
EventMaskOfScreen 
HeightOfScreen 
HeightMMOfScreen 
Keyboard 


LastKnownRequest— 
Processed , 


MaxCmapsOfScreen 
MinCmapsOfScreen 


NextRequest 
PlanesOfScreen 
ProtocolRevision 
ProtocolVersion 


QLength 


RootWindow 
RootWindowOfScreen 
ScreenCount 
XScreenNumberOfScreen 


ScreenOfDisplay 
ServerVendor 


VendorRelease 


WhitePixel 
WhitePixelOfScreen 


WidthOfScreen 


WidthMMOfScreen 
XDisplayMotionBufferSize 


Function Group Summary 


Return the string that was passed to XOpenDisplay or if 
that was NULL, the DISPLAY variable. 

Return the connected display manufacturer, as defined in 
<X11/Xvendors.h>. 

Return the width of the screen in pixels. 

Return the width of the specified screen in millimeters. 

Return a value indicating whether the screen supports backing 
stores. Return one of WhenMapped, NotUseful, or 
Always. 

Return whether the screen supports save unders. True or 
False. 

Return the file descriptor of the connected display. 

Return the initial root event mask for the specified screen. 
Return the height of the specified screen. 

Return the height of the specified screen in millimeters. 

Return the device ID for the main keyboard connected to the 
display. 

Return the serial ID of the last known protocol request to have 
been issued. 

Return the maximum number of colormaps supported by a 
screen. 
Return the minimum number of colormaps supported by a 
screen. 

Return the serial ID of the next protocol request to be issued. 
Return the number of planes in a screen. 

Return the minor protocol revision number of the X server. 
Return the version number of the X protocol on the connected 
display. 

Return the current length of the input queue on the connected 
display. 

Return the ID of the root window. 

Return the root window of the specified screen. 

Return the number of available screens. 

Return the integer corresponding to the specified pointer to a 
Screen Structure. 

Return the specified screen of the specified display. 

Return a pointer to a null-terminated string giving some identi- 
fication of the maker of the X server implementation. 

Return a number related to the release of the X server by the 
vendor. 

Return a pixel value representing white in default colormap. 
Return the white pixel value in the default colormap of the 
specified screen. 

Return the width of the specified screen. 

Return the width of the specified screen in millimeters. 

Return size of server’s motion history buffer. 
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Macros, Display (continued) 


XListDepths Return a list of the depths supported on this server. 
XListPixmapFormats Return a list of the pixmap formats supported on this server. 
XMaxRequestSize Return maximum request size allowed on this server. 
XResourceManagerString Return string containing user’s resource database. 


Macros, Image Format 





BitmapBitOrder Retunm LeastSignificant or MostSignificant. 
Indicates the bit order in BitmapUnit. 

BitmapPad Each scan line is padded to a multiple of bits specified by the 
value returned by this macro. 

BitmapUnit The scan line is quantized (calculated) in multiples of this 
value. 

ByteOrder Specifies the required byte order for images for each scan line 


unit in XYFormat (bitmap) or for each pixel value in ZFor- 
mat. Possible values are LSBFirst or MSBFirst. 

ImageByteOrder Specifies the required byte order for images for each scan line 
unit in XYFormat (bitmap) or for each pixel value in Z2For- 
mat. Return either LSBFirst orMSBFirst. 


Macros, Keysym Classification 


IsCursorKey Return True if the keysym is on the cursor key. 
IsFunctionKey Return True if the keysym is on the function keys. 
IsKeypadKey Return True if the keysym is on the key pad. 
IsMiscFunctionKkey Return True if the keysym is on the miscellaneous function keys. 
IsModifierKey Return True if the keysym is on the modifier keys. 

IsPFKey Return True if the keysym is on the PF keys. 

Mapping 


(see Window Mapping, Keyboard, or Pointer) 








Output Buffer 

XFlush Flush the request buffer. 

xSync Flush the request buffer and wait for all events to be processed 
by the server. 

Pointers 

XQueryPointer Get the current pointer location. 

XWarpPointer Move the pointer to another point on the screen. 

XGrabPointer Grab the pointer. 

XUngrabPointer Release the pointer from grab. 
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Pointers (continued) 





XGetPointerMapping 
XSetPointerMapping 
XGetPointerControl 
XChangePointerControl 
XChangeActivePointerGrab 


Properties 


XListProperties 

_ XDeleteProperty 
XChangeProperty 
XSetStandardProperties 
XRotateWindowProperties 
XGetAtomName 
XGetFontProperty 
XGetWindowProperty 
XInternAtom 
XGetTextProperty 
XSetTextProperty 
XStringListToTextProperty 
XTextPropertyToStringList 
XFreeStringList 


Regions 


XCreateRegion 
XDestroyRegion 
XEmptyRegion 
XPolygonRegion 
XPointInRegion 
XRect InRegion 
XUnionRectWithRegion 
XClipBox 
XOffsetRegion 
XShrinkRegion 
XEqualRegion 
XSetRegion 


XSubtractRegion 
XIntersectRegion 
XUnionRegion 
XXorRegion 


Function Group Summary 


Get the pointer button mapping. 

Set the pointer button mapping. 

Get the current pointer preferences. 

Change the pointer, preferences. 

Change the parameters of an active pointer grab. 


Get the property list for a window. 

Delete a window property. 

Change a property associated with a window. 

Set the minimum set of properties for the window manager. 
Rotate properties in the properties array. 

Get a name for a given atom. 

Get a font property given its atom. 

Obtain the atom type and property format for a window. 
Return an atom for a given name string. 

Read a TEXT property. 

Write a TEXT property. 

Convert a list of strings to an XText Property Structure. 
Convert an XText Property toa list of strings. 


Free memory allocated by XText PropertyToStringList. 


Create a new empty region. 

Deallocate storage associated with a region. 

Determine if a region is empty. 

Generate a region from points. 

Determine if a point resides in a region. 

Determine if a rectangle resides in a region. 

Add a rectangle to a region. 

Generate the smallest rectangle enclosing a region. 

Change offset of a region. 

Reduce the size of a region. 

Determine if two regions have the same size, offset, and space. 
Set clip mask of the graphics context to the specified 
region. 

Subtract one region from another. 

Compute the intersection of two regions. 

Compute the union of two regions. 

Calculate the difference between the union and intersection of 
2 regions. 
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Resource Manager 





XrmDestroyDatabase 
XrmGetFileDatabase 
XrmGetResource 
XrmGetStringDatabase 
XrmInitialize 
XrmMergeDatabases 
XrmParseCommand 
XrmPutFileDatabase 
XrmPutLineResource 
XrmPutResource 
XrmPutStringResource 
XrmQGetResource 
XrmQGetSearchList 
XrmQGet SearchResource 
XrmOPutResource 
XrmQPutStringResource 
XrmQuarkToString 
XrmStringToBinding-— 
QuarkList 
XrmStringToQuarkList 
XrmStringToQuark 
XrmUniqueQuark 
Xpermalloc 
XResourceManagerString 


Save Set 


XAddToSaveSet 
XRemoveFromSaveSet 
XChangeSaveSet 


Screen Saver 


Destroy a resource database. 

Retrieve a database from a file. 

Get a resource from name and class as strings. 

Create a database from a string. 

Initialize the resource manager. 

Merge the contents of one database with another. 

Load a resource database from command line arguments. 
Store a database in a file. 

Add a resource entry given as a string of name and value. 
Store a resource into a database. 

Add a resource that is specified as a string. 

Get a resource from name and class as quarks. 

Return a list of database levels. 

Search resource database levels for a given resource. 
Store a resource into a database using quarks. 

Add a string resource value to a database using quarks. 
Convert a quark to a string. 

Convert a key string to a binding list and a quark list. 


Convert a key string to a quark list. 

Convert a string to a quark. 

Allocate a new quark. 

Allocate memory never to be freed. 

Get user’s database set with xrdb from Display structure. 


Add a window to the client’s save-set. 
Remove a window from the client’s save-set. 
Add or remove a window to or from the client’s save-set. 





XActivateScreenSaver 
XForceScreenSaver 
XResetScreenSaver 
XGetScreenSaver 
XSetScreenSaver 


Selections 


Activate screen blanking. 

Turn the screen saver on or off. 

Reset the screen saver. 

Get the current screen saver parameters. 
Set the parameters of the screen saver. 





XGetSelectionOwner 
XSetSelectionOwner 
XConvertSelection 
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Return the owner of a selection. 
Set the owner of a selection. 
Use the value of a selection. 
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Server Specifications 
(see Display Specifications) 


Standard Geometry 





XGeomet ry 
XWMGeomet ry 
XParseGeometry 


XTranslateCoordinates 


Text 


XDrawImageString 
XDrawImageStringl6 
XDrawString 
XDrawStringl6 
XDrawText 
XDrawText16é 
XQueryTextExtents 
XQueryTextExtents1l6 


XTextExtents 
XTextExtentsl6é 
XTextWidth 
XTextWidthl6 


Calculate window geometry given user geometry string and 
default geometry. Superceded in R4 by XWMGeomet ry. 
Calculate window geometry given user geometry string and 
default geometry. 

Generate position and size from standard window geometry 
string. 

Change the coordinate system from one window to another. 


Draw 8-bit image text characters. 

Draw 16-bit image text characters. 

Draw an 8-bit text string, foreground only. 

Draw two-byte text strings. 

Draw 8-bit polytext strings. 

Draw 16-bit polytext strings. 

Query the server for string and font metrics. 

Query the server for string and font metrics of a 16-bit charac- 
ter string. 

Get string and font metrics. 

Get string and font metrics of a 16-bit character string. 
Get the width in pixels of an 8-bit character string. 
Get the width in pixels of a 16-bit character string. 


_ Tile, Pixmap, Stipple and Bitmap 


XCreatePixmap 

XFreePixmap 

XQueryBestSize 
XQueryBestStipple 
XQueryBestTile 

XSetTile 
XSetWindowBorderPixmap 
XSetWindowBackgroundPixmap 
XReadBitmapFile 
XWriteBitmapFile 
XCreateBitmapFromData 
XCreatePixmapFromBitmapData 
XListPixmapFormats 


Function Group Summary 


Create a pixmap. 

Free a pixmap ID. 

Obtain the "best" supported cursor, tile, or stipple size. 
Obtain the best supported stipple shape. 

Obtain the best supported fill tile shape. 

Set the fill tile in a graphics context. 

Change a window border tile attribute and repaint the border. 
Change the background tile attribute of a window. 

Read a bitmap from disk. 

Write a bitmap to a file. 

Create a bitmap from X11 bitmap format data. 

Create a pixmap with depth from bitmap data. 

Read supported p:xmap formats from Display structure. 
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User Preferences 





XAutoRepeatOff 
XAutoRepeatOn 

XBell 

XGetDefault 
XGetPointerControl 
XGetKeyboardControl 
XChangeKeyboardControl 


Turn off the keyboard auto-repeat keys. 

Turn on the keyboard auto-repeat keys. 

Ring the bell (Control G). 

Scan the user preferences for program name and options. 
Get the current pointer preferences. 

Obtain a list of the current keyboard preferences. 
Change the keyboard preferences. 





Visuals 

XGetVisualInfo Find a visual information structure that matches the specified 
template. 

XMatchVisualInfo Obtain the visual information that matches the desired depth 
and class. 

DefaultVisual Return the default visual structure for a screen. 


XVisualIDFromVisual 


Window Attributes 


XGetWindowAttributes 
XChangeWindowAttributes 
XSetWindowBackground 
XSetWindowBackgroundPixmap 
XSetWindowBorder 


XSetWindowBorderPixmap 
XSetWindowColormap 
XDefineCursor 
XGetGeometry 
XSelectInput 


Window Configuration 


Get resource ID from a visual structure. 


Obtain the current attributes of window. 

Set window attributes. 

Set the background pixel attribute of a window. 

Change the background tile attribute of a window. 

Change a window border attribute to the specified pixel value 
and repaint the border. 

Change a window border tile attribute and repaint the border. 
Set the colormap for a specified window. 

Assign a cursor to a window. 

Obtain the current geometry of drawable. 

Select the event types to be sent to a window. 





XMoveWindow 
XResizeWindow 
XMoveResizeWindow 
XSetWindowBorderWidth 
XRestackWindows 
XConfigureWindow 


XGetGeometry 
XReconfigureWMWindow 
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Move a window. 

Change a window’s size. 

Change the size and position of a window. 

Change the border width of a window. 

Change the stacking order of siblings. 

Change the window position, size, border width, or stacking 
order. 

Obtain the current geometry of drawable. 

Change top-level window position, size, border width, or 
stacking order. 
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Window Existence 


XCreateSimpleWindow Create an unmapped Input Output subwindow. 
Create a window and set attributes. 
Destroy all subwindows of a window. 


Unmap and destroy 4 window and all subwindows. 


XCreateWindow 
XDestroySubwindows 
XDestroyWindow 


Window Manager Hints 


XGetClassHint Get the XA_WM_CLASS property of a window. Obsolete in 
R4. 

XSetClassHint Set the XA_WM_CLASS property of a window. Obsolete in 
R4. . 

XGetNormalHints Get the size hints property of a window in normal state (not 
zoomed or iconified). Obsolete in R4. 

XSetNormalHints Set the size hints property of a window in normal state (not 
zoomed or iconified). Obsolete in R4. 

XGetSizeHints Read any property of type XA_WM_SIZE_ HINTS. Obsolete 
in R4. 

XSetSizeHints Set the value of any property of type XA_WM_— 


XGetTransientForHint 
XSetTransientForHint 


SIZE_HINTS. Obsolete in R4. 
Get the XA_WM_TRANSIENT_ FOR property of a window. 
Set the XA_WM TRANSIENT FOR property of a window. 


XGetWMHints Read a window manager hints property. 

XSetWMHints Set a window manager hints property. 

XGetZoomHints Read the size hints property of a zoomed window. Obsolete in 
R4. 

XSetZoomHints Set the size hints property of a zoomed window. Obsolete in 
R4. 

XFetchName Get a window’s name (XA_WM NAME property). Obsolete in 
R4. 

XStoreName Assign a name to a window for the window manager. Obsolete 
in R4. 

XGet IconName Get the name to be displayed in an icon. Obsolete in R4. 

XSet IconName Set the name to be displayed in a window’s icon. Obsolete in 
R4. 

XGetIconSizes Get preferred icon sizes. 

XSetIconSizes Set the value of the XA_WM_ICON_ SIZE property. 

XSetCommand Set the XA_WM_COMMAND property (command line arguments). 
Obsolete in R4. 

XAllocClassHint Allocate and zero fields in XClassHint structure. 

XAllocIconSize Allocate and zero fields in XIconSize structure. 

XAllocSizeHints Allocate and zero fields in XSizeHints structure. 

XAllocStandardColormap Allocate and zero fields in XSt andardColormap structure. 

XAllocWMHints Allocate and zero fields in XWMHints structure. 


Function Group Summary 
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Window Manager Hints (continued) 





XGetRGBColormaps 
XSetRGBColormaps 


XGetWMClientMachine 
XSetWMClientMachine 
XGetWMIconName 


XSetWMIconName 


XGetWMProtocols 
XSetWMProtocols 
XGetWMNormalHints 


XSetWMNormalHints 
XSetWMSizeHints 


XSetWMColormapWindows 
XGetWMColormapWindows 
XSetWMProperties 


XSetWMName 
XGetWMName 


Window Manipulation 


XLowerWindow 
XRaiseWindow 
XCirculateSubwindows 
XCirculateSubwindowsDown 
XCirculateSubwindowsUp 
XQueryTree 
XReparentWindow 
XMoveWindow 
XResizeWindow 
XMoveResizeWindow 
XSetWindowBorderWidth 
XRestackWindows 
XConfigureWindow 


XIconifyWindow 
XWithdrawWindow 


XReconfigurewWwMWindow 
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Read standard colormap property. Replaces xGetStan- 
dardColormap. 

Write standard colormap property. Replaces xSetStan- 
dardColormap. 

Read WM_CLIENT MACHINE property. 

Write WM_CLIENT_MACHINE property. 

Read XA_WM_ICON_NAME property. Replaces xGet— 
IconName. 

Write XA_WM_ICON_NAME property. Replaces XSet- 
IconName. 

Read WM_PROTOCOLS property. 

Write WM_PROTOCOLS property. 

Read XA_WM_ NORMAL HINTS property. Replaces XGet- 
NormalHints. 

Write XA_WM_ NORMAL HINTS property. Replaces XSet- 
NormalHints. 

Write XA_WM_ SIZE HINTS property. Replaces xSet- 
SizeHints. 

Write WM_COLORMAP_WINDOWS property. 

Read WM_COLORMAP_WINDOWS property. 

Write all standard properties. Replaces XSetStan- 
dardProperties. 

Write XA_WM_NAME property. Replaces XStoreName. 
Read XA_WM_NAME property. Replaces XFet chName. 


Lower a window in the stacking order. 

Raise a window to the top of the stacking order. 

Circulate the stacking order of children up or down. 

Circulate the bottom child to the top of the stacking order. 
Circulate the top child to the bottom of the stacking order. 
Return a list of children, parent, and root. 

Change a window’s parent. 

Move a window. 

Change a window’s size. 

Change the size and position of a window. 

Change the border width of a window. 

Change the stacking order of siblings. 

Change the window position, size, border width, or stacking 
order. 

Inform window manager that a top-level window should be 
iconified. 

Inform window manager that a top-level window should be 
unmapped. 


Reconfigure a top-level window. 
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Window Mapping 


XMapRaised Map a window on top of its siblings. 

XMapSubwindows Map all subwindows. 

XMapWindow Map a window. 

XUnmapSubwindows Unmap all subwindows of a given window. 

XUnmapWindow Unmap a window. 

XIconifyWindow Inform window manager that a top-level window should be iconified. 
XWithdrawWindow Inform window manager that a top-level window should be unmapped. 





Alphabetical Listing of Routines 


Table A-1. Alphabetical Listing of Routines 


Routine 


Description 





XActivateScreenSaver 
XAddHost 

XAddHosts 

XAddPixel 
XAddToSaveSet 
XAllocClassHint 
XAllocIconSize 
XAllocSizeHints 
XAllocStandardColormap 
XAllocWMHints 
XAllocColor 


XAllocColorCells 
XAllocColorPlanes 
XAllocNamedColor 
XAllowEvents 


XAutoRepeatOff 
XAutoRepeatOn 

XBell 
XChangeActivePointerGrab 
XChangeGC 
XChangeKeyboardControl 
XChangeKeyboardMapping 
XChangePointerControl 
XChangeProperty 
XChangeSaveSet 
XChangeWindowAttributes 
XCheckIfEvent 
XCheckMaskEvent 


Function Group Summary 


Activate screen blanking. 

Add a host to the access control list. 

Add multiple hosts to the access control list. 

Add a constant value to every pixel value in an image. 
Add a window to the client’s save-set. 

Allocate and zero fields in XClassHint structure. 
Allocate and zero fields in XIconSize structure. 
Allocate and zero fields in XS izeHints structure. 
Allocate and zero fields in XSt andardColormap structure. 
Allocate and zero fields in XWMHints structure. 
Allocate a read-only colormap cell with closest hardware- 
supported color. 

Allocate read/write (nonshared) colorcells. 

Allocate read/write (nonshareable) color planes. 

Allocate a read-only colorcell from color name. 

Control the behavior of keyboard and pointer events when 
these resources are grabbed. 

Turn off the keyboard auto-repeat keys. 

Turn on the keyboard auto-repeat keys. 

Ring the bell (Control G). 

Change the parameters of an active pointer grab. 

Change the components of a given graphics context. 
Change the keyboard preferences such as key click. 
Change the keyboard mapping. 

Change the pointer preferences. 

Change a property associated with a window. 

Add or remove a window to or from the client’s save-set. 
Set window attributes. 

Check the event queue for a matching event. 

Remove the next event that matches mask; don’t wait. 
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Table A-1. Alphabetical Listing of Routines (continued) 


Routine 





XCheckTypedEvent 
XCheckTypedWindowEvent 
XCheckWindowEvent 


XCirculateSubwindows 
XCirculateSubwindowsDown 


XCirculateSubwindowsUp 


XClearArea 
XClearWindow 
XClipBox 
XCloseDisplay 
XConfigureWindow 


XConvertSelection 
XCopyArea 
XCopyColormapAndFree 
XCopyGC 

XCopyPlane 


XCreateAssocTable 
XCreateBitmapFromData 
XCreateColormap 
XCreateFontCursor 
XCreateGC 


XCreateGlyphCursor 
XCreateImage 
XCreatePixmap 
XCreatePixmapCursor 
XCreatePixmapF rom-— 
BitmapData 
XCreateRegion 
XCreateSimpleWindow 
XCreateWindow 
XDefineCursor 
XDeleteAssoc 
XDeleteContext 
XDeleteModifiermapEntry 
XDeleteProperty 
XDestroyAssocTable 
XDestroyImage 
XDestroyRegion 
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Description 


Return the next event in queue that matches event type; 
Return the next event in queue matching type and window. 
Remove the next event matching both passed window and 
passed mask; don’t wait. 

Circulate the stacking order of children up or down. 
Circulate the bottom child to the top of the 

stacking order. 

Circulate the top child to the bottom of the 

stacking order. 

Clear a rectangular area in a window. 

Clear an entire window. 

Generate the smallest rectangle enclosing a region. 
Disconnect a client program from an X server and display. 
Change the window position, size, border width, or stacking 
order. . 

Use the value of a selection. 

Copy an area of a drawable. 

Copy a colormap and return a new colormap ID. 

Copy a graphics context. 

Copy a single plane of a drawable into a drawable with depth, 
applying pixel values. 

Create a new association table (X10). 

Create a bitmap from X11 bitmap format data. 

Create a colormap. 

Create a cursor from the standard cursor font. 

Create a new graphics context for a given screen with the depth 
of the specified drawable. 

Create a cursor from font glyphs. 

Allocate memory for an XImage structure. 

Create a pixmap. 

Create a cursor from two bitmaps. 

Create a pixmap with depth from bitmap data. 


Create a new empty region. 

Create an unmapped Input Output window. 
Create a window and set attributes. 

Assign a cursor to a window. 

Delete an entry from an association table. 

Delete a context entry for a given window and type. 
Delete an entry from an XModif ierKeymap structure. 
Delete a window property. 

Free the memory allocated for an association table. 
Deallocate memory associated with an image. 
Deallocate storage associated with a region. 
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Table A-1. Alphabetical Listing of Routines (continued) 





XDestroySubwindows 
XDestroyWindow 


XDisableAccessControl 


XDisplayKeycodes 


XDisplayMotionBufferSize 


XDisplayName 
XDraw 

XDrawArc 
XDrawArcs 
XDrawFilled 
XDrawImageString 
XDrawImageStringl6 
XDrawLine 
XDrawLines 
XDrawPoint 
XDrawPoints 
XDrawRectangle 
XDrawRectangles 
XDrawSegments 
XDrawString 
XDrawStringl6é 
XDrawText 
XDrawText1l6é 
XEmptyRegion 
XEnableAccessControl 
XEqualRegion 
XEventsQueued 
XFetchBuffer 
XFetchBytes 
XFetchName 
XFillArc 
XFillArcs 
XFillPolygon 
XFillRectangle 
XFillRectangles 
XFindContext 
XFlush 
XForceScreenSaver 
XFree 
XFreeColormap 
XFreeColors 
XFreeCursor 


Function Group Summary 


Destroy all subwindows of a window. 

Unmap and destroy a window and all subwindows. 

Allow access from any host. 

Returns range of keycodes used by server. 

Return size of server’s motion history buffer. 

Report the display name when connection to a display fails. 
Draw a polyline or curve between vertex list (from X10). 
Draw an arc fitting inside a rectangle. 

Draw multiple arcs. 

Draw a filled polygon or curve from vertex list (from X10). 
Draw 8-bit image text characters. 

Draw 16-bit image text characters. 

Draw a line between two points. 

Draw multiple connected lines. 

Draw a point. 

Draw multiple points. 

Draw an outline of a rectangle. 

Draw the outlines of multiple rectangles. 

Draw multiple disjoint lines. 

Draw an 8-bit text string, foreground only. 

Draw two-byte text strings. 

Draw 8-bit polytext strings. 

Draw 16-bit polytext strings. 

Determine if a region is empty. 

Use access control list to allow or deny connection requests. 


Determine if two regions have the same size, offset, and shape. 


Check the number of events in the event queue. 

Return data from a cut buffer. 

Return data from cut buffer 0. 

Get a window’s name (XA_WM_NAME property). 

Fill an arc. 

Fill multiple arcs. 

Fill a polygon. 

Fill a rectangular area. 

Fill multiple rectangular areas. 

Get data from the context manager (not graphics context). 
Flush the request buffer (display all queued requests). 
Turn the screen saver on or off. 

Free specified in-memory data created by an Xlib function. 
Delete a colormap and install the default colormap. 

Free colormap cclls or planes. 

Destroy a cursor. 
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Table A-1. Alphabetical Listing of Routines (continued) 


Routine 





XFreeExtensionList 


XFreeFont 
XFreeFontInfo 
XFreeFontNames 
XFreeFontPath 

XF reeGC 
XFreeModifiermap 
XFreePixmap 
XFreeStringList 


XGContextFromGC 
XGeometry 


XGetAtomName 
XGetClassHint 
XGetDefault 
XGetErrorDatabaseText 
XGetErrorText 
XGetFontPath 
XGetFontProperty 
XGetGeometry 
XGetGCValues 

XGet IconName 
XGetIconSizes 

XGet Image 
XGetInputFocus 
XGetKeyboardControl 
XGetKeyboardMapping 
XGetModifierMapping 
XGetMotionEvents 
XGetNormalHints 


XGetPixel 
XGetPointerControl 
XGetPointerMapping 
XGetRGBColormaps 


XGetScreenSaver 
XGetSelectionOwner 
XGetSizeHints 
XGetStandardColormap 
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Description 


Free memory allocated for a list of installed 

extensions to X. 

Unload a font and free storage for the font structure. 
Free multiple font information arrays. 

Free the font name array. 

Free the memory allocated by XGet FontPath. 

Free a graphics context. 

Destroy and free a keyboard modifier mapping structure. 
Free a pixmap ID. 

Free memory allocated by XText Property-— 
ToStringList. 

Obtain the GContext (resource ID) associated 

with the specified graphics context. 

Calculate window geometry given user geometry string 
and default geometry. 

Get a name for a given atom. 

Get the XA_WM_CLASS property of a window. 

Scan the user preferences for program name and options. 
Obtain error messages from the error database. 

Obtain a description of error code. 

Get the current font search path. 

Get a font property given its atom. 

Obtain the current geometry of drawable. 

Get GC component values from Xlib’s GC cache. 

Get the name to be displayed in an icon. 

Get preferred icon sizes. 

Place contents of a rectangle from drawable into an image. 
Return the current keyboard focus window. 

Obtain a list of the current keyboard preferences. 
Return symbols for keycodes. 

Obtain a mapping of modifier keys (Shift, Control, etc.). 
Get pointer motion events. 

Get the size hints property of a window in normal state (not 
zoomed or iconified). 

Obtain a single pixel value from an image. 

Get the current pointer preferences. 

Get the pointer button mapping. 

Read standard colormap property. 

Replaces XGet StandardColormap. 

Get the current screen saver parameters. 

Return the owner of a selection. 

Read any property of type XA_WM_SIZE_HINTS. 
Get the standard colormap property. 
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Table A-1. Alphabetical Listing of Routines (continued) 





XGetSubImage 


XGetTextProperty 
XGetTransientForHint 
XGetVisualInfo 


XGetWindowAttributes 
XGetWindowProperty 
XGetWMClientMachine 
XGetWMColormapWindows 
XGetWMHints 
XGetWMIconName 


XGetWMName 
XGetWMNormalHints 


XGetWMProtocols 
XGetWMSizeHints 


XGetZoomHints 
XGrabButton 
XGrabKey 
XGrabKeyboard 
XGrabPointer 
XGrabServer 
XIconifyWindow 


XI fEvent 
XInsertModifiermapEntry 
XInstallColormap 
XInternAtom 
XIintersectRegion 
XKeycodeToKeysym 
XKeysymToKeycode 
XKeysymToString 
XKillClient 

XListDepths 
XListExtensions 
XListFonts 
XListFontsWithInfo 
XListHosts 
XListInstalledColormaps 
XListPixmapFormats 


Function Group Summary 


Copy a rectangle in drawable to a location within the 
pre-existing image. 
Read a TEXT property. 


Get the XA_WM_TRANSIENT_FOR property of a window. 


Find a visual information structure that matches the 
specified template. 

Obtain the current attributes of window. 

Obtain the atom type and property format for a window. 
Read WM_CLIENT_ MACHINE property. 

Read WM_COLORMAP_ WINDOWS property. 

Read a window manager hints property. 

Read XA_WM_ICON_NAME property. 

Replaces XGet IconName. 

Read XA_WM_NAME property. Replaces XFet chName. 
Read XA_WM_NORMAL HINTS property. Replaces 
XGetNormalHints. 

Read WM_PROTOCOLS property. 

Read XA_WM_ SIZE HINTS property. Replaces 
XGetSizeHints. 

Read the size hints property of a zoomed window. 

Grab a pointer button. 

Grab a key. 

Grab the keyboard. 

Grab the pointer. 

Grab the server. 

Inform window manager that a top-level window should 
be iconified. 

Wait for matching event. 

Add a new entry to an XModifierKeymap structure. 
Install a colormap. 

Return an atom for a given name string. 

Compute the intersection of two regions. 

Convert a keycode to a keysym. 

Convert a keysym to the appropriate keycode. 

Convert a keysym symbol to a string. 

Destroy a client or its remaining resources. 

Return a list of the depths supported on this server. 
Return a list of all extensions to X supported by the server. 
Return a list of the available font names. 

Obtain the names and information about loaded fonts. 
Obtain a list of hosts having access to this display. 

Get a list of installed colormaps. 

Return a list of the pixmap formats supported on 

this server. 
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Table A-1. Alphabetical Listing of Routines (continued) 


Routine 


XListProperties 
XLoadFont 
XLoadQueryFont 
XLookUpAssoc 
XLookupColor 


XLookupKeysym 
XLookupString 


XLowerWindow 
XMakeAssoc 
XMapRaised 
XMapSubwindows 
XMapWindow 
XMaskEvent 
XMatchVisuallInfo 


XMaxRequestSize 
XMoveResizeWindow 
XMoveWindow 
XNewModifiermap 
XNextEvent 

XNoOp 
XOffsetRegion 
XOpenDisplay 
XParseColor 


XParseGeometry 


XPeekEvent 
XPeekIfEvent 


XPending 


Xpermalloc 
XPointInRegion 
XPolygonRegion 
XPutBackEvent 
XPut Image 
XPutPixel 
XQueryBestCursor 
XQueryBestSize 
XQueryBestStipple 
XQueryBestTile 
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Get the property list for a window. 
Load a font if not already loaded; get font ID. 

Load a font and fill information structure. 

Obtain data from an association table. 

Get database RGB values and closest hardware-supported 
RGB values from color name. 

Get the keysym corresponding to a keycode in structure. 
Map a key event to ASCII string, keysym, and 
ComposeStatus. 

Lower a window in the stacking order. 

Create an entry in an association table. 

Map a window on top of its siblings. 

Map all subwindows. 

Map a window. 

Remove the next event that matches mask. 

Obtain the visual information that matches the desired 
depth and class. 

Return maximum request size allowed on this server. 
Change the size and position of a window. 

Move a window. 

Create a keyboard modifier mapping structure. 

Get the next event of any type or window. 

Send a NoOp to exercise connection with the server. 
Change offset of a region. 

Connect a client program to an X server. 

Look up or translate RGB values from ASCII color name 
or hexadecimal value. 

Generate position and size from standard window 
geometry string. 

Get an event without removing it from the queue. 

Get an event without removing it from the queue; 

do not wait. 

Flush the request buffer and return the number of pending 
input events. 

Allocate memory never to be freed. 

Determine if a point is inside a region. 

Generate a region from points. 

Push an event back on the input queue. 

Draw a rectangular image on a window or pixmap. 

Set a pixel value in an image. 

Get the closest supported cursor sizes. 

Obtain the "best" supported cursor, tile, or stipple size. 
Obtain the best supported stipple shape. 

Obtain the best supported fill tile shape. 
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Table A-1. Alphabetical Listing of Routines (continued) 


Routine 


XQueryColor 


XQueryColors 
XQueryExtension 
XQueryFont 
XQueryKeymap 
XQueryPointer 
XQueryTextExtents 
XQueryTextExtents16 


XQueryTree 
XRaiseWindow 
XReadBitmapFile 
XRebindKeysym 
XRecolorCursor 
XReconfigureWMWindow 


XRect InRegion 
XRefreshKeyboardMapping 
XRemoveF romSaveSet 
XRemoveHost 
XRemoveHosts 
XReparentWindow 
XResetScreenSaver 
XResizeWindow 
XResourceManagerString 
XRestackWindows 
XrmDestroyDatabase 
XrmGetFileDatabase 
XrmGetResource 
XrmGetStringDatabase 
XrmIinitialize 
XrmMergeDatabases 
XrmParseCommand 
XrmPutFileDatabase 
XrmPutLineResource 


XrmPutResource 
XrmPutStringResource 
XrmQGetResource 
XrmQGetSearchList 
XrmQGetSearchResource 
XrmQPutResource 
XrmOPutStringResource 


Function Group Summary 






Obtain the RGB values and flags for a specified pixel 


value. ‘ 

Obtain RGB values for an array of pixel values. 

Get extension information. 

Return information about a loaded font. 

Obtain a bit vector for the current state of the keyboard. 
Get the current pointer location. 

Query the server for string and font metrics. 

Query the server for string and font metrics 

of a 16-bit character string. 

Return a list of children, parent, and root. 

Raise a window to the top of the stacking order. 
Read a bitmap from disk. 

Rebind a keysym to a string for client. 

Change the color of a cursor. 

Change top-level window position, size, border width, or 
stacking order. 

Determine if a rectangle resides in a region. 

Update the stored modifier and keymap information. 
Remove a window from the client’s save-set. 
Remove a host from the access control list. 

Remove multiple hosts from the access control list. 
Change a window’s parent. 

Reset the screen saver. 

Change a window’s size. 

Return string containing user’s resource database. 
Change the stacking order of siblings. 

Destroy a resource database. 

Retrieve a database from a file. 

Get a resource from name and class as strings. 
Create a database from a string. 

Initialize the resource manager. 

Merge the contents of one database with another. 
Load a resource database from command line arguments. 
Store a database in a file. 

Add a resource entry given as a string of name and 
value. 

Store a resource into a database. 

Add a resource that is specified as a string. 

Get a resource from name and class as quarks. 
Return a list of database levels. 

Search resource database levels for a given resource. 
Store a resource into a database using quarks. 

A.dd a string resource value to a database using quarks. 
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Table A-1. Alphabetical Listing of Routines (continued) 


Routine 


XrmQuarkToString 
XrmStringToBinding—- 
QuarkList 
XrmStringToQuark 
XrmStringToQuarkList 
XrmUniqueQuark 
XRotateBuffers 


XRotateWindowProperties 


XSaveContext 


XSelectInput 
XSendEvent 
XSetAccessControl 
XSetAfterFunction 
XSetArcMode 
XSetBackground 
XSetClassHint 
XSetClipMask 
XSetClipOrigin 
XSetClipRectangles 


XSetCloseDownMode 
XSetCommand 
XSetDashes 
XSetErrorHandler 
XSetFillRule 
XSetFillStyle 
XSetFont 
XSetFontPath 
XSetForeground 
XSetFunction 
XSetGraphicsExposures 
XSet IconName 
XSetIconSizes 
XSetInputFocus 

XSet IOErrorHandler 
XSetLineAttributes 
XSetModifierMapping 


XSetNormalHints 


XSetPlaneMask 
XSetPointerMapping 
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Convert a quark to a string. 

Convert a key string to a binding list and a quark 

list. 

Convert a string to a quark. 

Convert a key string to a quark list. 

Allocate a new quark. 

Rotate the cut buffers. 

Rotate properties in the properties array. 

Save a data value corresponding to a window and 
context type (not graphics context). 

Select the event types to be sent to a window. 

Send an event. 

Disable or enable access control. 

Set a function called after all Xlib functions. 

Set the arc mode in a graphics context. 

Set the background pixel value in a graphics context. 
Set the XA_WM_CLASS property of a window. 

Set clip _mask pixmap in a graphics context. 

Set the clip origin in a graphics context. 

Change clip_mask ina graphics context to the 

list of rectangles. 

Change the close down mode of a client. 

Set the XA_WM_COMMAND atom (command line arguments). 
Set dash_offset and dashes (for lines) in a graphics context. 
Set a nonfatal error event handler. 

Set the fill rule in a graphics context. 

Set the fill style in a graphics context. 

Set the current font in a graphics context. 

Set the font search path. 

Set the foreground pixel value in a graphics context. 
Set the bitwise logical operation in a graphics context. 
Set graphics exposures ina graphics context. 
Set the name to be displayed in a window’s icon. 

Set the value of the XA_WM_ICON_ SIZE property. 
Set the keyboard focus window. 

Handle fatal I/O errors. 

Set the line drawing components in a graphics context. 
Set keycodes to be used as modifiers (Shift, Control, 
etc.). 

Set the size hints property of a window in normal state 
(not zoomed or iconified). 

Set the plane mask in a graphics context. 

Set the pointer button mapping. 
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Table A-1. Alphabetical Listing of Routines (continued) 





XSetRegion 
XSetRGBColormaps 


XSetScreenSaver 
XSetSelectionOwner 
XSetSizeHints 
XSetStandardColormap 
XSetStandardProperties 
XSetState 


XSetStipple 
XSetSubwindowMode 
XSetTextProperty 
XSetTile 
XSetTransientForHint 


XSetTSOrigin 
XSetWindowBackground 
XSetWindowBackground- 
Pixmap 
%SetWindowBorder 


XSetWindowBorderPixmap 
XSetWindowBorderWidth 
XSetWindowColormap 
XSetwMClientMachine 
XSetwWMColormapWindows 
XSetWMHints 
XSetwMiconName 
XSetwWMName 
XSetWMNormalHints 


XSetwWMProperties 


XSetwWMProtocols 
XSetwWMSizeHints 


XSetZoomHints 


%ShrinkRegion 
XStoreBuffer 


Function Group Summary 


Set clip_mask of the graphics context to 
the specified région. 

Write standard colormap property. Replaces 
XSetStandardColormap. 

Set the parameters of the screen saver. 

Set the owner of a selection. 


Set the value of any property of type XA_WM_SIZE_ HINTS. 


Change the standard colormap property. 

Set the minimum set of properties for the window manager. 
Set the foreground, background, logical function, and 
plane mask in a graphics context. 

Set the stipple in a graphics context. 

Set the subwindow mode in a graphics context. 
Write a TEXT property using XText Property structure. 
Set the fill tile in a graphics context. 

Set the XA_WM_TRANSIENT_FOR property 

of a window. 

Set the tile/stipple origin in a graphics context. 

Set the background pixel attribute of a window. 
Change the background tile attribute of 

a window. 

Change a window border attribute to the specified 
pixel value and repaint the border. 

Change a window border tile attribute and repaint 
the border. 

Change the border width of a window. 

Set the colormap for a specified window. 

Write WM_CLIENT MACHINE property. 

Write WM_COLORMAP WINDOWS property. 

Set a window manager hints property. 

Write XA_WM_ICON_ NAME property. Replaces 
XSet IconName. 

Write XA_WM_NAME property. Replaces 
XStoreName. 

Write XA_WM_NORMAL HINTS property. 
Replaces XSetNormalHints. 

Write all standard properties. Replaces 
XSetStandardProperties. 

Write WM_PROTOCOLS property. 

Write XA_WM_ SIZE HINTS property. Replaces 
XSetSizeHinces. 

Set the size hints property of a zoomed window. 
Reduce or expand the size of a region. 

Store data in a cut buffer. 
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Table A-1. Alphabetical Listing of Routines (continued) 


Routine 


XStoreBytes 
XStoreColor 


XStoreColors 


XStoreName 
XStoreNamedColor 
XStringListToTextProperty 


XStringToKeysym 
XSubImage 
XSubtractRegion 
XSync 


XSynchronize 
XTextExtents 
XTextExtents1l6 
XTextWidth 
XTextWidth16 
XTranslateCoordinates 


XUndefineCursor 
XUngrabButton 
XUngrabKey 
XUngrabKeyboard 
XUngrabPointer 
XUngrabServer 
XUninstallColormap 


XUnionRectWithRegion 
XUnionRegion 
XUniqueContext 
XUnloadFont 
XUnmapSubwindows 
XUnmapWindow 
XWarpPointer 
XWindowEvent 
XWMGeometry 


XWriteBitmapFile 
XXorRegion 
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Store data in cut buffer 0. 

Set or change a read/write entry of a colormap to the closest 
available hardware color. 

Set or change read/write colorcells to the closest available 
hardware colors. 

Assign a name to a window for the window manager. 
Allocate a read/write colorcell by English color name. 
Convert a list of strings to an XText Property 
structure. 

Convert a keysym name string to a keysym. 

Create a subimage from part of an image. 

Subtract one region from another. 

Flush the request buffer and wait for all events and errors 
to be processed by the server. 

Enable or disable synchronization for debugging. 

Get string and font metrics. 

Get string and font metrics of a 16-bit character string. 
Get the width in pixels of an 8-bit character string. 

Get the width in pixels of a 16-bit character string. 
Change the coordinate system from one window to 
another. 

Disassociate a cursor from a window. 

Release a button from grab. 

Release a key from grab. 

Release the keyboard from grab. 

Release the pointer from grab. 

Release the server from grab. 

Uninstall a colormap; install default if not 

already installed. 

Add a rectangle to a region. 

Compute the union of two regions. 

Create a new context ID (not graphics context). 

Unload a font. 

Unmap all subwindows of a given window. 

Unmap a window. 

Move the pointer to another point on the screen. 
Remove the next event matching mask and window. 
Calculate window geometry given user geometry string 
and default geometry. 

Write a bitmap to a file. 

Calculate the difference between the union and intersection 
of two regions. 
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| B 
Error Messages and Protocol Requests 


This appendix contains two tables: Table B-1 describes the standard error codes (the 
error code member of XErrorEvent) and what causes them, and Table B-2 describes 
the mapping between protocol requests and Xlib functions. Each reference page in this vol- 
ume describes in more detail the errors that may occur because of that Xlib routine. Volume 
One, Chapter 3, Basic Window Program, describes the handling of errors in general. 


A protocol request is the actual network message that is sent from Xlib to the server. Many 
convenience functions are provided in Xlib to make programs easier to write and more read- 
able. When any one of several convenience routines is called it will be translated into one 
type of protocol request. For example, XMoveWindow and XResizeWindow are conve- 
nience routines for the more general XConfigureWindow. Both of these Xlib routines 
use the protocol request ConfigureWindow. The protocol request that causes an error, along 
with other information about the error is printed to the standard error output by the default 
error handlers. In order to find out where in your code the error occurred, you will need to 
know what Xlib function to look for. Use Table B-2 to find this function. 


Xlib functions that do not appear in Table B-2 do not generate protocol requests. They per- 
form their function without affecting the display and without requiring information from the 
server. If errors can occur in them, the errors are reported in the returned value. 


Table B-1. Error Messages 






Possible Cause 





Error Codes: 





Specifies that the client attempted to grab a key/button combination 
that is already grabbed by another client; free a colormap entry that 
is not allocated by the client; store into a read-only colormap entry; 
modify the access control list from other than the local (or otherwise 
authorized) host; or select an event type that only one client can 
select at a time, when another client has already selected it. 


BadAccess 


BadAlloc Specifies that the server failed to allocate the requested resource. 


Specifies that a value for an Atom argument does not name a defined 
Atom. 


BadAtom 
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Table B-1. Error Messages (continued) 


Error Codes: Possible Cause 

BadColor Specifies that a value for a Colormap argument does not name a 
defined Colormap. 

BadCursor Specifies that a value for a Cursor argument does not name a 
defined Cursor. 

BadDrawable Specifies that a value for a Drawable argument does not name a 
defined Window or Pixmap. 

BadFont Specifies that a value for a Font or GContext argument does not 
name a defined Font. 

BadGC Specifies that a value for a GContext argument does not name a 
defined GContext. 

BadIDChoice Specifies that the value chosen for a resource identifier either is not 
included in the range assigned to the client or is already in use. 

BadImplement- | Specifies that the server does not implement some aspect of the 

ation request. A server that generates this error for a core request is defi- 
cient. Clients should be prepared to receive such errors and either 
handle or discard them. 

BadLength Specifies that the length of a request is shorter or longer than that 
required to minimally contain the arguments. This usually indicates 
an internal Xlib error. 

BadMatch Specifies that an Input On1y window is used as a Drawable. 
Some argument (or pair of arguments) has the correct type and range 
but fails to ‘‘match’’ in some other way required by the request. 

BadName Specifies that a font or color of the specified name does not exist. 

BadPixmap Specifies that a value for a Pixmap argument does not name a 
defined Pixmap. 

BadRequest Specifies that the major or minor opcode does not specify a valid 
request. 

BadValue Specifies that some numeric value falls outside the range of values 
accepted by the request. Unless a specific range is specified for an 
argument, the full range defined by the argument’s type is accepted. 
Any argument defined as a set of alternatives can generate this error. 

BadWindow Specifies that a value for a Window argument does not name a 





defined Window. 


The BadAtom, BadColor, BadCursor, BadDrawable, BadFont, BadGC, Bad- 
Pixmap, and BadWindow errors are also used when the argument type should be among a 
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set of fixed alternatives (for example, a window ID, PointerRoot, or None) and some 
other constant or variable is used. 


Table B-2. Xlib Functions and Protocol Requests 


Protocol Request 
AllocColor 
AllocColorCells 
AllocColorPlanes 
AllocNamedColor 
AllowEvents 

Bell 
ChangeActivePointerGrab 
ChangeGC 


ChangeHosts 


ChangeKeyboardControl 


ChangeKeyboardMapping 
ChangePointerControl 
ChangeProperty 


4 


Xlib Function 





XAllocColor 


XAllocColorCells 
XAllocColorPlanes 
XAllocNamedColor 
XAllowEvents 

XBell 
XChangeActivePointerGrab 


XChangeGC 
XSetArcMode 
XSetBackground 
XSetClipMask 
XSetClipOrigin 
XSetFillRule 
XSetFillStyle 
XSetFont 
XSetForeground 
XSetFunction 
XSetGraphicsExposures 
XSetLineAttributes 
XSetPlaneMask 
XSetState 
XSetStipple 

XSet SubwindowMode 
XSetTile 
XSetTSOrigin 


XAddHost 
XAddHosts 
XRemoveHost 
XRemoveHosts 


XAutoRepeatOff 
XAutoRepeatOn 
XChangeKeyboardControl 


XChangeKeyboardMapping 
XChangePointerControl 


XChangeProperty 
XSetCommand 
XSetIconName 
XSetIconSizes 
XSetNormalHints 
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Table B-2. Xlib Functions and Protocol Requests (continued) 


Protocol Request 


ChangeSaveSet 


ChangeWindowAttributes 


Circulate Window 


ClearArea 
CloseFont 


Configure Window 


ConvertSelection 
CopyArea 
CopyColormapAndFree 
CopyGC 

CopyPlane 
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Xlib Function 





XSetWMProperties 
XSetSizeHints 
XSetStandardProperties 
XSetWMHints 
XSetZoomHints 
XStoreBuffer 
XStoreBytes 

XStoreName 


XAddToSaveSet 
XChangeSaveSet 
XRemoveFromSaveSet 


XChangeWindowAttributes 
XDefineCursor 

XSelect Input 
XSetWindowBackground 
XSetWindowBackgroundPixmap 
XSetWindowBorder 
XSetWindowBorderPixmap 
XSetWindowColormap 
XUndefineCursor 


XCirculateSubwindows 
XCirculateSubwindowsDown 
XCirculateSubwindowsUp 


XClearArea 
XClearWindow 


XFreeFont 
XUnloadFont 


XConfigureWindow 
XLowerWindow 
XMapRaised 
XMoveResizewWindow 
XMoveWindow 
XRaiseWindow 
XReconfigureWMWindow 
XResizeWindow 
XRestackWindows 
XSetWindowBorderWidth 


XConvertSelection 
XCopyArea 
XCopyColormapAndF ree 
XCopyGC 


XCopyPlane 


~ 
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Table B-2. Xlib Functions and Protocol Requests (continued) 





Protocol Request 
CreateColormap 


CreateCursor 
CreateGC 


CreateGlyphCursor 


CreatePixmap 
Create Window 


DeleteProperty 
DestroySubwindows 
- DestroyWindow 
FillPoly 


ForceScreenSaver 


FreeColormap 
FreeColors 
FreeCursor 
FreeGC 
FreePixmap 
GetAtomName 
GetFontPath 
GetGeometry 


GetImage 
GetInputFocus 


GetKeyboardControl 
GetKeyboardMapping 
GetModifierMapping 
GetMotionEvents 
GetPointerControl 
GetPointerMapping 






Xlib Function 
XCreateColormap 
XCreatePixmapCursor 


XCreateGC 
XOpenDisplay 


XCreateFontCursor 
XCreateGlyphCursor 


XCreatePixmap 


XCreateSimpleWindow 
XCreateWindow 


XDeleteProperty 
XDestroySubwindows 
XDestroyWindow 
XFillPolygon _ 


XActivateScreenSaver 
XForceScreenSaver 
XResetScreenSaver 


XFreeColormap 
XFreeColors 
XFreeCursor 
XFreeGC 
XFreePixmap 
XGetAtomName 
XGetFontPath 


XGetGeometry 
XGetWindowAttributes 


XGet Image 


XGetInputFocus 
XSync 


XGetKeyboardControl 
XGetKeyboardMapping 
XGetModifierMapping 
XGetMotionEvents 
XGetPointerControl 


XGetPonterMapping 
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Table B-2. Xlib Functions and Protocol Requests (continued) 


Protocol Request 


GetProperty 


GetScreenSaver 
GetSelectionOwner 
GetWindowAttributes 
GrabButton 

GrabKey 
GrabKeyboard 
GrabPointer 
GrabServer 
ImageText8 
ImageText16 
InstallColormap 
InternAtom 
KillClient 
ListExtensions 
ListFonts 
ListFontsWithInfo 
ListHosts 
ListInstalledColormaps 
ListProperties 
LookupColor 


MapSubwindows 
MapWindow 


NoOperation 
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Xlib Function 





XFetchBytes 
XFetchName 
XGetIconSizes 

XGet IconName 
XGetNormalHints 
XGetSizeHints 
XGetWindowProperty 
XGetWMProperties 
XGetWMHints 
XGetZoomHints 


XGetScreenSaver 
XGetSelectionOwner 
XGetWindowAttributes 
XGrabButton 

XGrabKey 
XGrabKeyboard 
XGrabPointer 
XGrabServer 
XDrawImageString 
XDrawImageStringl6 
XInstallColormap 
XInternAtom 
XKil1Client 
XListExtensions 
XListFonts 
XListFontsWithInfo 
XListHosts 
XListInstalledColormaps 
XListProperties 


XLookupColor 
XParseColor 


XMapSubwindows 


XMapRaised 
XMapWindow 


XNoOp 
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Table B-2. Xlib Functions and Protocol Requests (continued) 


Protocol Request 
OpenFont 


PolyArc 
PolyFillArc 
PolyFillRectangle 


PolyLine 
PolyPoint 


PolyRectangle 
PolySegment 
PolyText8 
PolyText16 


PutImage 
QueryBestSize 


QueryColors 
QueryExtension 


QueryFont 
QueryKeymap 
QueryPointer 
QueryTextExtents 


QueryTree 
RecolorCursor 
ReparentWindow 
RotateProperties 


Xlib Function 





XLoadFont 
XLoadQueryFont 


XDrawArc 
XDrawArcs 


XFillArc 
XFillArcs 


XFillRectangle 
XFillRectangles 


XDrawLines 


XDrawPoint 
XDrawPoints 


XDrawRectangle 
XDrawRectangles 


XDrawLine 
XDrawSegments 


XDrawString 
XDrawText 


XDrawStringl6é 
XDrawTextl16 


XPut Image 


XQueryBestCursor 
XQueryBestSize 
XQueryBestStipple 
XQueryBestTile 


XQueryColor 
XQueryColors 


XInitExtension 
XQueryExtension 


XLoadQueryFont 
XQueryKeymap 
XQueryPointer 


XQueryTextExtents 
XQueryTextExtents16 


XQueryTree 
XRecolorCursor 
XReparentWindow 


XRotateBuffers 
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Table B-2. Xlib Functions and Protocol Requests (continued) 


Protocol Request 


SendEvent 
SetAccessControl 


SetClipRectangles 
SetCloseDownMode 
SetDashes 
SetFontPath 
SetInputFocus 
SetModifierMapping 
SetPointerMapping 
SetScreenSaver 
SetSelectionOwner 


StoreColors 


StoreNamedColor 
TranslateCoords 
UngrabButton 
UngrabKey 
UngrabKeyboard 
UngrabPointer 
UngrabServer 
UninstallColormap 
UnmapSubwindows 
UnmapWindow 
WarpPointer 
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Xlib Function 
XRotateWindowProperties 
XSendEvent 


XDisableAccessControl 
XEnableAccessControl 
XSetAccessControl 


XSetClipRectangles 
XSetCloseDownMode 
XSetDashes 
XSetFontPath 
XSetInputFocus 
XSetModifierMapping 
XSetPointerMapping 
XSetScreenSaver 
XSetSelectionOwner 


XStoreColor 
XStoreColors 


XStoreNamedColor 
XTranslateCoordinates 
XUngrabButton 
XUngrabKey 
XUngrabKeyboard 
XUngrabPointer 
XUngrabServer 
XUninstallColormap 
XUnmapSubWindows 
XUnmapWindow 


XWarpPointer 
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3 C 


Macros 


Once you have successfully connected your application to an X server, you can obtain data 
from the Display structure associated with that display. The Xlib interface provides a 
number of useful C language macros and corresponding functions for other language bind- 
ings which return data from the Display structure. 


The function versions of these macros have the same names as the macros except that the 
function forms begin with the letter “X.” They use the same arguments. Using the macro 
versions is slightly more efficient in C because it eliminates function call overhead. 


In R3 and R4, a few new functions were added that access members of the Display struc- 
ture. These are XDisplayMotionBufferSize, XResourceManagerString, 
XDisplayKeycodes, and XMaxRequestSize in R3 and XScreenNumber- 
OfScreen, XListDepths, and XListPixmapFormats in R4. Also, XVisual- 
IDFromVisual was added in R3 to extract the resource ID from a visual structure. 
XDisplayMotionBufferSize, XResourceManagerString, XMaxRequest-— 
Size, XScreenNumberOf Screen, and XVisualIDFromVisual are simple enough 
to have macro versions, but these were not provided. Nevertheless, we have chosen to cover 
them in this macro appendix instead of devoting a reference page to each. XDisplay- 
Keycodes, XListDepths, and XListPixmapFormats are more complicated and 
therefore have their own reference pages; they are not covered here. 


For the purposes of this appendix, the macros are divided into four categories: Display mac- 
ros, Image Format macros, Keysym Classification macros, and Resource Manager macros. 
The macros are listed alphabetically within each category. 


Note that some macros take as arguments an integer screen (scr_num) while others take a 
pointer to a Screen Structure (scr_ptr). scr_num is returned by the Default- 
Screen macro and scr_pt ris returned by the DefaultScreenOfDisplay macro. 
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C.1 Display Macros 
AllPlanes 
BlackPixel(display,scr_num) 
BlackPixelOfScreen(scr_ptr) 
CellsOfScreen(scr_ptr) 


ConnectionNumber(display) 
DefaultColormap(display,scr_num) 


DefaultColormapOfScreen(scr_ ptr) 


DefaultDepth(display,scr_num) 


DefaultDepthOfScreen(scr_ptr) 


DefaultGC(display,scr_num) 
DefaultGCOfScreen(scr_ptr) 


DefaultRootWindow(display) 


DefaultScreen(display) 
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Return a value with all bits set suitable for use as 
a plane mask argument. 


Return the black pixel value in the default color- 
map that is created by XOpenDisplay. 


Return the black pixel value in the default color- 
map of the specified screen. 


Return the number of colormap cells in the 
default colormap of the specified screen. 


Return a connection number for the specified 
display. On a UNIX system, this is the file 
descriptor of the connection. 


Return the default colormap for the specified 
screen. Most routine allocations of color should 
be made out of this colormap. 


Return the default colormap of the specified 
screen. 


Return the depth (number of planes) of the root 
window for the specified screen. Other depths 
may also be supported on this screen. See Vol- 
ume One, Chapter 7, Color, or the reference 
pages for XMatchVisualInfo and XGet- 
VisualiInfo to find out how to determine 
what depths are available. 


Return the default depth of the specified screen. 


Return the default graphics context for the speci- 
fied screen. 


Return the default graphics context (GC) of the 
specified screen. 


Return the ID of the root window on the default 
screen. Most applications should use Root- 
Window instead so that screen selection is sup- 
ported. 


Return the integer that was specified in the last 
segment of the string passed to XOpen- 
Display or from the DISPLAY environment 
variable if NULL was used. For example, if the 
DISPLAY environment were Ogre:0.1, then 
DefaultScreen would return 1. 
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DefaultScreenOfDisplay(display) 
DefaultVisual(display,scr_ num) 


DefaultVisualOfScreen(scr_ptr) 


DisplayCells(display,scr_num) 


DisplayHeight(display,scr_num) 
DisplayHeightMM(display,scr_num) 


DisplayOfScreen(scr_ ptr) 


DisplayP lanes(display,scr_num) 


DisplayString(display) 


DisplayWidth(display,scr_num) 
DisplayWidthMM(display,scr_num) 


DoesBackingStore(scr_ ptr) 


DoesSaveUnders(scr_ ptr) 
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Return the default screen of the specified dis- 
play. 


Return a pointer to the default visual structure 
for the specified screen. 


Return the default visual of the specified screen. 


Return the maximum possible number of color- 
map cells on the specified screen. This macro is 
misnamed: it should have been Screen- 
Cells. 


Return the height in pixels of the screen. This 
macro is misnamed: it should have been 
ScreenHeight. 


Return the height in millimeters of the specified 
screen. This macro is misnamed: it should have 
been ScreenHeightMM. 


Return the display associated with the specified 
screen. 


Return the number of planes on the specified 
screen. This macro is misnamed: it should have 
been ScreenPlanes. 


Return the string that was passed to XOpen- 
Display when the current display was opened 
(or, if that was NULL, the value of the DISPLAY 
environment variable). This macro is useful in 
applications which invoke the fork system call 
and want to open a new connection to the same 
display from the child process. 


Return the width in pixels of the screen. This 
macro iS misnamed: it should have been 
ScreenWidth. 


Return the width in millimeters of the specified 
screen. This macro is misnamed: it should have 
been ScreenWidthMM. 


Return a value indicating whether the screen 
supports backing stores. Values are When- 
Mapped, NotUseful, or Always. See Vol- 
ume One, Section 4.3.5 for a discussion of the 
backing store. 


Return. a Boolean value indicating whether the 
screen supports save unders. If True, the 
screen supports save unders. If False, the 
screen does not support save unders. See 
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dpyno(display) 


EventMaskOfScreen(scr_ptr) 


HeightOfScreen(scr_ ptr) 


HeightMMOfScreen(scr_ ptr) 


Keyboard(display) 


LastKnownRequestProcessed 
(display) 


MaxCmapsOfScreen(scr_ ptr) 


MinCmapsOfScreen(scr ptr) 


NextRequest (display) 


PlanesOfScreen(scr_ ptr) 


ProtocolRevision(display) 


ProtocolVersion(display) 


QLength(display) 


RootWindow(display,scr_ num) 
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Volume One, Section 4.3.6 for a discussion of 
the save under. 


Return the file descriptor of the connected dis- 
play. On a UNIX system, you can then pass this 
returned file descriptor to the select(3) system 
call when your application program is driving 
more than one display at a time. 


Return the initial event mask for the root win- 
dow of the specified screen. 


Return the height in pixels of the specified 
screen. 


Return the height in millimeters of the specified 
screen. 


Return the device ID for the main keyboard con- 
nected to the display. 


Return the serial ID of the last known protocol 
request to have been issued. This can be useful 
in processing errors, since the serial number of 
failing requests are provided in the XError- 
Event structure. 


Return the maximum number of installed (hard- 
ware) colormaps supported by the specified 
screen. 


Return the minimum number of installed (hard- 
ware) colormaps supported by the specified 
screen. 


Return the serial ID of the next protocol request 
to be issued. This can be useful in processing 
errors, since the serial number of failing requests 
are provided in the XErrorEvent structure. 


Return the number of planes in the specified 
screen. 


Return the minor protocol revision number of 
the X server. 


Return the version number of the X protocol 
associated with the connected display. This is 
currently 11. 


Return the number of events that can be queued 
by the specified display. 


Return the ID of the root window. This macro is 
necessary for routines that reference the root 
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window or create a top-level window for an 


application. 

RootWindowOfScreen(scr_ ptr) Return the ID of the root window of the speci- 
fied screen. 

ScreenCount (display) Return the number of available screens on a 
specified display. 

ScreenOfDisplay(display,scr num) Return the specified screen of the specified dis- 
play. 

ServerVendor(display) Return a pointer to a null terminated string giv- 
ing some identification of the owner of the X 
server implementation. 

VendorRelease(display) Return a number related to the release of the X 
server by the vendor. 

WhitePixel(display,scr_num) Return the white pixel value in the default color- 
map that is created by XOpenDisplay. 

WhitePixelOfScreen(scr ptr) Return the white pixel value in the default color- 
map of the specified screen. 

WidthOfScreen(scr ptr) Return the width of the specified screen. 

WidthMMOfScreen(scr ptr) Return the width of the specified screen in milli- 
meters. 

XDisplayMotionBufferSize(display) Ed 
Return an unsigned long value containing = 
the size of the motion buffer on the server. If Bs 
this function returns zero, the server has no ‘ 
motion history buffer. 

XMaxRequestSize(display) Return a long value containing the maximum 





size of a protocol request for the specified server, 
in units of four bytes. 


XScreenNumberOfScreen(scr_ ptr) Return the integer screen number corresponding 
to the specified pointer to a Screen structure. 


XVisualIDFromVisual(visual) Returns the ID of the server resource associated 
with a visual structure. This is useful when stor- 
ing standard colormap properties. 
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C.2 Image Format Macros 


C.3 


BitmapBitOrder(display) 


BitmapPad(display) 


BitmapUnit(display) 


ImageByteOrder(display) 


Within each BitmapUnit, the leftmost bit in the bit- 
map as displayed on the screen is either the least or the 
most significant bit in the unit. Returns LSBFirst or 
MSBFirst. 


Each scan line must be padded to a multiple of bits speci- 
fied by the value returned by this macro. 


Returns the size of a bitmap’s unit. The scan line is quan- 
tized (calculated) in multiples of this value. 


Returns the byte order for images required by the server 
for each scan line unit in XY format (bitmap) or for each 
pixel value in Z format. Values are LSBFirst or 
MSBFirst. 


Keysym Classification Macros 


You may want to test if a keysym of the defined set (XK_MISCELLANY) is, for example, on 
the key pad or the function keys. You can use the keysym macros to perform the following 


tests: 
IsCursorKey(keysym) 
IsFunctionKey(keysym) 
IsKeypadKey(keysym) 


IsMiscFunctionKey(keysym) 


IsModifierKey(keysym) 


IsPFKey(keysym) 


Return True if the keysym represents a cursor key. 
Return True if the keysym represents a function key. 
Return True if the keysym represents a key pad. 


Return True if the keysym represents a miscellaneous 
function key. 


Return True if the keysym represents a modifier key. 


Return True if the keysym represents a PF key. 


Resource Manager Macros 


These macros convert from strings to quarks and quarks to strings. They are used by the 
resource manager. Note that they do not follow the normal naming conventions for macros, 


since they begin with an X. 


XrmStringToName(string) 


XrmStringToClass(string) 
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Convert string to XrmName. Same as XString- 
ToQuark. 


Convert string to XrmClass. Same as XString- 
ToQuark. 
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XrmStringToRepresentation Convert string to XrmRepresentation. Same as 


(string) XStringToQuark. 
XrmNameToString(name) Convert XrmName to string. Same as XrmQuark- 
ToString. 
XrmClassToString(class) Convert XrmClass to string. Same as XrmQuark- 
ToString. 


XrmRepresentationToString Convert XrmRepresentation to string. Same as 
(type) XrmQuarkToString. 


XResourceManagerString(display) 
Return a pointer to the resource database string stored 


in the Display Structure. This string is read from the 
RESOURCE_MANAGER property on the root window; 
this property is normally set by the xrdb client. 
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D 
The Color Database 


The color database translates color name strings into RGB values. It is used by XParse- 
Color, XLookupColor, and XStoreNamedColor. These routines make it easier to 
allow the user to specify color names. Use of these names for routine color allocation of 
read-only colorcells is encouraged since this increases the chance of sharing colorcells and 
thereby makes the colormap go further before running out of colorcells. The location in the 
file system of the text version of the color database is an implementation detail, but by 
default on a UNIX system it is /usr/lib/X11/rgb.txt. 


It should be noted that while a sample color database is provided with the standard X11 dis- 
tribution, it is not specified as an X Consortium standard and is not part of the X Protocol or 
Xlib. Therefore, it is permissible for server vendors to change the color names, although they 
will probably only add color names. Furthermore, hardware vendors can change the RGB 
values for each display hardware to achieve the proper “gamma correction” so that the colors 
described by the name really generate that color. 


The RGB values in the R3 database were originally tuned for the DEC VT240 display. The 
color that appears on a Sun system given these RGB values for “pink,” for example, looks 
more like light burgundy. In R4 a new RGB color database is provided, which provides 
many more color names and provides values that generate colors that match their names on 
more monitors. 


Each color name in the database may be used in the form shown or in mixed case, with initial 
capitals and all spaces eliminated. Table D-1 (see next page) shows the R3 database, and 
Table D-2 shows the R4 database. 
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Table D-1. The R3 Color Database* 


English Words English Words 
English Words medium aquamarine 
aquamarine English Words. 
black medium blue 

blue medium forest green 
blue violet medium goldenrod 
brown medium orchid 
cadet blue medium sea green 
coral medium slate blue 
cornflower blue medium spring green 
cyan medium turquoise 
dark green medium violet red 
dark olive green midnight blue 
dark orchid navy 

dark slate blue navy blue 

dark slate gray orange 

dark slate grey orange red 

dark turquoise orchid 

dim gray pale green 

dim grey pink 

firebrick 

forest green 

gold 

goldenrod 

gray sea green 

green sienna 

green yellow sky blue 

grey slate blue 

indian red spring green 
khaki steel blue 

light blue tan 

light gray thistle 

light grey turquoise 

light steel blue violet 

lime green violet red 
magenta wheat 

maroon white 

yellow yellow green 





*Also defined are the color names “gray0” through “gray100”, spelled with an “e” or an “a”. “gray0” is black and 
“gray 100” is white. 
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Table D-2. The R4 Color Database 


English Words 


snow 
ghost white 
GhostWhite 
white smoke 
WhiteSmoke 
gainsboro 
floral white 
Floral White 
old lace 
OldLace 

linen 

antique white 
Antique White 
papaya whip 
PapayaWhip 
blanched almond 
BlanchedAlmond 
bisque 

peach puff 
PeachPuff 
navajo white 
NavajoWhite 
moccasin 
cornsilk 

ivory 

lemon chiffon 
LemonChiffon 
seashell 
honeydew 
mint cream 
MintCream 
azure 

alice blue 
AliceBlue 
lavender 
lavender blush 
LavenderBlush 
misty rose 
MistyRose 
white 
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Red 


Green 


English Words 


black 

dark slate gray 
DarkSlateGray 
dark slate grey 
DarkSlateGrey 
dim gray 
DimGray 

dim grey 
DimGrey 

slate gray 
SlateGray 

slate grey 
SlateGrey 

light slate gray 
LightSlateGray 
light slate grey 
LightSlateGrey 
gray 

grey 

light grey 
LightGrey 

light gray 
LightGray 
midnight blue 
MidnightBlue 
navy 

navy blue 
NavyBlue 
cornflower blue 
CornflowerBlue 
dark slate blue 
DarkSlateBlue 
slate blue 
SlateBlue 
medium slate blue 
MediumSlateBlue 
light slate blue 
LightSlateBlue 
medium blue 
MediumBlue 
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Table D-2. The R4 Color Database (continued) 


English Words 


royal blue 
RoyalBlue 

blue 

dodger blue 
DodgerBlue 

deep sky blue 
DeepSkyBlue 

sky blue 

SkyBlue 

light sky blue 
LightSkyBlue 
steel blue 
SteelBlue 

light steel blue 
LightSteelBlue 
light blue 
LightBlue 
powder blue 
PowderBlue 

pale turquoise 
PaleTurquoise 
dark turquoise 
DarkTurquoise 
medium turquoise 
MediumTurquoise 
turquoise 

cyan 

light cyan 
LightCyan 

cadet blue 
CadetBlue 
medium aquamarine 
MediumAquamarine 
aquamarine 

dark green 
DarkGreen 

dark olive green 
DarkOliveGreen 
dark sea green 
DarkSeaGreen 
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Red 


65 
65 

0 
30 
30 


Green 


105 
105 

0 
144 
144 
191 


Blue 


225 
225 
255 


English Words 


sea green 
SeaGreen 

medium sea green 
MediumSeaGreen 
light sea green 
LightSeaGreen 

pale green 
PaleGreen 

spring green 
SpringGreen 

lawn green 
LawnGreen 

green 

chartreuse 

medium spring green 
MediumSpringGreen 
green yellow 
GreenYellow 

lime green 
LimeGreen 

yellow green 
YellowGreen 

forest green 
ForestGreen 

olive drab 
OliveDrab 

dark khaki 
DarkKhaki 

khaki 

pale goldenrod 
PaleGoldenrod 

light goldenrod yellow 
LightGoldenrodYellow 
light yellow 
LightYellow 

yellow 

gold 

light goldenrod 
LightGoldenrod 
goldenrod 
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152 


124 
124 


Blue 


Table D-2. The R4 Color Database (continued) 


English Words 
dark goldenrod 


DarkGoldenrod 


rosy brown 
RosyBrown 
indian red 
IndianRed 
saddle brown 
SaddleBrown 
sienna 

peru 
burlywood 
beige 

wheat 

sandy brown 
SandyBrown 
tan 
chocolate 
firebrick 
brown 

dark salmon 
DarkSalmon 
salmon 

light salmon 
LightSalmon 
orange 

dark orange 
DarkOrange 
coral ! 
light coral 
LightCoral 
tomato 
orange red 
OrangeRed 
red 

hot pink 
HotPink 
deep pink 
DeepPink 
pink 

light pink 


Red 


184 
184 
188 
188 
205 
205 
139 
139 
160 
205 
222 
245 
245 
244 
244 
210 
210 
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Green 
134 


Blue 


11 
11 
143 


193 


English Words 
LightPink 

pale violet red 
PaleVioletRed 
maroon 
medium violet red 
MediumVioletRed 
violet red 
VioletRed 
magenta 

violet 

plum 

orchid 

medium orchid 
MediumOrchid 
dark orchid 
DarkOrchid 
dark violet 
DarkViolet 
blue violet 
BlueViolet 
purple 

medium purple 
MediumPurple 
thistle 

snowl 

snow2 

snow3 

snow4 
seashell1 
seashell2 
seashell3 
seashell4 
AntiqueWhitel 
AntiqueWhite2 
AntiqueWhite3 
AntiqueWhite4 
bisquel 
bisque2 
bisque3 
bisque4 
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Table D-2. The R4 Color Database (continued) 


English Words 


PeachPuff1 
PeachPuff2 
PeachPuff3 
PeachPuff4 
NavajoWhitel 
NavajoWhite2 
NavajoWhite3 
Navajo White4 
LemonChiffon1 
LemonChiffon2 
LemonChiffon3 
LemonChiffon4 
cornsilk1 
cornsilk2 
cornsilk3 
cornsilk4 

ivory1 

ivory2 

ivory3 

ivory4 
honeydewl 
honeydew2 
honeydew3 
honeydew4 
LavenderBlush1 
LavenderBlush2 
LavenderBlush3 
LavenderBlush4 
MistyRose1 
MistyRose2 
MistyRose3 
MistyRose4 
azurel 

azure2 

azure3 

azure4 
SlateBlue1 
SlateBlue2 
SlateBlue3 
SlateBlue4 
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Red 


255 
238 


Green 


218 
203 


Blue 


185 
173 
149 
101 
173 
161 
139 

94 
205 
191 
165 
112 
220 
205 
177 
120 
240 
224 
193 
131 
240 
224 
193 
131 
245 
229 
197 
134 
225 
210 
181 
123 
255 
238 
205 
139 
255 
238 
205 
139 


English Words 
LightPink 

pale violet red 
PaleVioletRed 
maroon 
medium violet red 
MediumVioletRed 
violet red 
VioletRed 
magenta 

violet 

plum 

orchid 
medium orchid 
MediumOrchid 
dark orchid 
DarkOrchid 
dark violet 
DarkViolet 
blue violet 
BlueViolet 
purple 

medium purple 
MediumPurple 
thistle 

snowl 

snow2 

snow3 

snow4 
seashell1 
seashell2 
seashell3 
seashell4 
AntiqueWhitel 
AntiqueWhite2 
AntiqueWhite3 
AntiqueWhite4 
bisque1l 
bisque2 
bisque3 
bisque4 


199 | 21 133 
199 | 21 133 
208 | 32 144 
208 | 32 144 
255 |) 0 255 


148 | 0 211 
148 | 0 211 
138 | 43 226 
138 | 43 226 
160 | 32 240 
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Table D-2. The R4 Color Database (continued) 
Red 


English Words 


RoyalBlue1 
RoyalBlue2 
RoyalBlue3 
RoyalBlue4 
bluel 

blue2 

blue3 

blue4 
DodgerBluel 
DodgerBlue2 
DodgerBlue3 
DodgerBlue4 
SteelBlue1 
SteelBlue2 
SteelBlue3 
SteelBlue4 
DeepSkyBluel 
DeepSkyBlue2 
DeepSkyBlue3 
DeepSkyBlue4 
SkyBluel 
SkyBlue2 
SkyBlue3 
SkyBlue4 
LightSkyBluel 
LightSkyBlue2 
LightSkyBlue3 
LightSkyBlue4 
SlateGray1 
SlateGray2 
SlateGray3 
SlateGray4 
LightSteelBlue1 
LightSteelBlue2 
LightSteelBlue3 
LightSteelBlue4 
LightBluel 
LightBlue2 
LightBlue3 
LightBlue4 
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191 


154 
104 


Green 


118 
110 
a) 


Blue 


255 
238 
205 
139 


English Words 


LightCyan1 
LightCyan2 
LightCyan3 
LightCyan4 
PaleTurquoise1 
PaleTurquoise2 
PaleTurquoise3 
PaleTurquoise4 
CadetBlue1 
CadetBlue2 
CadetBlue3 
CadetBlue4 
turquoise] 
turquoise2 
turquoise3 
turquoise4 
cyanl 

cyan2 

cyan3 

cyan4 
DarkSlateGray1 
DarkSlateGray2 
DarkSlateGray3 
DarkSlateGray4 
aquamarine1l 
aquamarine2 
aquamarine3 
aquamarine4 
DarkSeaGreen1 
DarkSeaGreen2 
DarkSeaGreen3 
DarkSeaGreen4 
SeaGreenl 
SeaGreen2 
SeaGreen3 
SeaGreen4 
PaleGreen1 
PaleGreen2 
PaleGreen3 
PaleGreen4 
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Table D-2. The R4 Color Database (continued) 


English Words 


SpringGreen1 
SpringGreen2 
SpringGreen3 
SpringGreen4 
green] 

green2 

green3 

green4 
chartreusel 
chartreuse2 
chartreuse3 
chartreuse4 
OliveDrab1 
OliveDrab2 
OliveDrab3 
OliveDrab4 
DarkOliveGreen1 
DarkOliveGreen2 
DarkOliveGreen3 
DarkOliveGreen4 
khakil 

khaki2 

khaki3 

khaki4 
LightGoldenrod1 
LightGoldenrod2 
LightGoldenrod3 
LightGoldenrod4 
LightYellow1 
LightYellow2 
LightYellow3 
LightYellow4 
yellowl 

yellow2 

yellow3 

yellow4 

gold1 

gold2 

gold3 

gold4 


596 


Red 


139 


Green 


2S 
238 
205 
139 
255; 
238 
205 
139 


Blue 


127 
118 
102 


English Words 


goldenrod1 
goldenrod2 
goldenrod3 
goldenrod4 
DarkGoldenrod1 
DarkGoldenrod2 
DarkGoldenrod3 
DarkGoldenrod4 
RosyBrownl 
RosyBrown2 
RosyBrown3 
RosyBrown4 
IndianRed1 
IndianRed2 
IndianRed3 
IndianRed4 
siennal 

sienna2 

sienna3 

sienna4 
burlywood1 
burlywood2 
burlywood3 
burlywood4 
wheatl 

wheat2 

wheat3 

wheat4 

tanl 

tan2 

tan3 

tan4 

chocolate1 
chocolate2 
chocolate3 
chocolate4 
firebrick1 
firebrick2 
firebrick3 
firebrick4 


738 1 09 99 
205 | 85 85 
139 | 58 58 


139 | 69 19 
255 | 48 48 
238 | 44 44 
205 | 38 38 
139 | 26 26 
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Table D-2. The R4 Color Database (continued) 
English Words | Red | Green | Blue || English Words Red | Green | Blue 





brownl 255 64 |. 64 || HotPinkl 255 *1*110 180 

brown2 238 59 59 || HotPink2 238 | 106 167 

brown3 205 51 51 || HotPink3 205 | 96 144 

brown4 139 35 35 || HotPink4 139 | 58 98 

salmonl 255 140 105 || pinkl 255 | 181 197 

salmon2. 238 130 98 || pink2 238 | 169 184 

salmon3 205 112 84 || pink3 205 | 145 158 

salmon4 139 76 57 || pink4 139 | 99 108 

LightSalmonl | 255 160 122 || LightPink1 255 | 174 185 

LightSalmon2 | 238 149 114 || LightPink2 238 | 162 173 

LightSalmon3 | 205 129 98 || LightPink3 205 | 140 149 

LightSalmon4 | 139 87 66 || LightPink4 139 | 95 101 

orangel 255 165 0 || PaleVioletRed1 2555130 171 

orange2 238 154 0 || PaleVioletRed2 238 | 121 159 

orange3 205 133 0 || PaleVioletRed3 205 | 104 137 

orange4 139 90 0 || PaleVioletRed4 139 | 71 93 

DarkOrange1 ZI5 127 0 || maroon1 2)” | oe 179 

DarkOrange2 238 118 0 || maroon2 238 | 48 167 

DarkOrange3 205 102 0 || maroon3 205 | 41 144 

DarkOrange4 139 69 0 || maroon4 139 | 28 98 

corall 255 114 86 || VioletRed1 254i. 62 150 

coral2 238 106 80 || VioletRed2 238 | 58 140 

coral3 205 91 69 || VioletRed3 205 | SO 120 

coral4 139 62 47 || VioletRed4 139 | 34 82 

tomatol 255 99 71 || magental 255 | 0 255 

tomato2 238 92 66 || magenta2 238 | 0 238 

tomato3 205 79 57 || magenta3 205 | 0 205 

tomato4 139 54 38 || magenta4 139 | 0 139 

OrangeRed1 250 69 0 || orchidl 2551131 250 

OrangeRed2 238 64 0 || orchid2 238-04 122 233 

OrangeRed3 205 55 0 || orchid3 205 | 105 201 

OrangeRed4 139 37 0 || orchid4 139 | 71 137 

redl 255 0 0 || pluml 255 | 187 255 =) 
red2 238 0 0 || plum2 238 | 174 238 a 
red3 205 0 0 || plum3 205 | 150 205 c 
red4 139 0 0 || plum4 139 | 102 139 a 
DeepPink1 255 20 147 || MediumOrchidl | 224 | 102 255 

DeepPink2 238 18 137 || MediumOrchid2 | 209 | 95 238 

DeepPink3 205 16 118 || MediumOrchid3 | 180 | 82 205 

DeepPink4 139 10 80 || MediumOrchid4 | 122 | 55 139 
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Table D-2. The R4 Color Database" (continued) 
English Words 


DarkOrchid1 
DarkOrchid2 
DarkOrchid3 
DarkOrchid4 
purplel 

purple2 

purple3 

purple4 
MediumPurple1 
MediumPurple2 
MediumPurple3 
MediumPurple4 
thistle1 

thistle2 

thistle3 

thistle4 





*Also defined are the color names “gray0” through “gray 100”, spelled with and “e” or an “a”. “gray0” is black and 
“gray 100” is white. 
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E 


Event Reference 


This appendix describes each event structure in detail and briefly shows how each event type 
is used. It covers the most common uses of each event type, the information contained in 
each event structure, how the event is selected, and the side effects of the event, if any. Each 
event is described on a separate reference page. 


Table E-1 lists each event mask, its associated event types, and the associated structure defi- 
nition. See Chapter 8, Events, of Volume One, Xlib Programming Manual, for more informa- 


tion on events. 


Table E-1. Event Masks, Event Types, and Event Structures 


KeyPressMask 
KeyReleaseMask 
ButtonPressMask 
ButtonReleaseMask 
OwnerGrabButtonMask 
KeymapStateMask 


PointerMotionMask 
PointerMotionHintMask 
ButtonMot ionMask 
Button1MotionMask 
Button2MotionMask 
Button3MotionMask 
Button4MotionMask 
Button5Mot ionMask 


EnterWindowMask 
LeaveWindowMask 


FocusChangeMask 


Appendix E: Event Reference 


KeyPress 
KeyRelease 


ButtonPress 


ButtonRelease 
n/a 
KeymapNotify 


MotionNotify 


EnterNotify 


LeaveNotify 





FocusIn 
FocusOut 


XKeyPressedEvent 
XKeyReleasedEvent 
XButtonPressedEvent 
XButtonReleasedEvent 
n/a 

XKeymapEvent 


XPointerMovedEvent 


XEnterWindowEvent 
XLeaveWindowEvent 


XFocusInEvent 
XFocusOutEvent 
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Table E-1. Event Masks, Event Types, and Event Structures (continued) 


Event Mask Structure 
ExposureMask Expose XExposeEvent 
selected in GC by GraphicsExpose XGraphicsExposeEvent 
graphics expose member NoExpose XNoExposeEvent 
ColormapChangeMask ColormapNotify XColormapEvent 
PropertyChangeMask PropertyNotify XPropertyEvent 
VisibilityChangeMask VisibilityNotify | XVisibilityEvent 
ResizeRedirectMask ResizeRequest XResizeRequestEvent 
StructureNotifyMask CirculateNotify XCirculateEvent 
ConfigureNotify XConfigureEvent 
DestroyNotify XDestroyWindowEvent 
GravityNotify XGravityEvent 
MapNotify S XMapEvent 
ReparentNotify XReparentEvent 
UnmapNotify XUnmapEvent 
SubstructureNotifyMask CirculateNotify XCirculateEvent 
ConfigureNotify XConfigureEvent 
CreateNotify XCreateWindowEvent 
DestroyNotify XDestroyWindowEvent 
GravityNotify XGravityEvent 
MapNotify XMapEvent 
ReparentNotify XReparentEvent 
UnmapNotify XUnmapEvent 


SubstructureRedirectMask CirculateRequest XCirculateRequestEvent 
ConfigureRequest XConfigureRequestEvent 
MapRequest XMapRequestEvent 


(always selected) MappingNotify XMappingEvent 

(always selected) ClientMessage XClientMessageEvent 
(always selected) SelectionClear XSetSelectClearEvent 
(always selected) SelectionNotify XSelectionEvent 


(always selected) SelectionRequest | XSelectionRequestEvent 





600 Xlib Reference Manual 


E.1 Meaning of Common Structure Elements 


Example E-1 shows the XEvent union and a simple event structure that is one member of 
the union. Several of the members of this structure are present in nearly every event struc- 
ture. They are described here before we go into the event-specific members (see also Sec- 
tion 8.2.2 of Volume One, X/ib Programming Manual). 


Example E-1. XEvent union and XAnyEvent structure 


typedef union XEvent { 
int type; /* Must not be changed; first member */ 
XAnyEvent xany; 
XButtonEvent xbutton; -° 
XCirculateEvent xcirculate; 
XCirculateRequestEvent xcirculaterequest; 
XClientMessageEvent xclient; 
XColormapEvent xcolormap; 
XConfigureEvent xconfigure; 
XConfigureRequestEvent xconfigurerequest; 
XCreateWindowEvent xcreatewindow; 
XDestroyWindowEvent xdestroywindow; 
XCrossingEvent xcrossing; 
XExposeEvent xexpose; 
XFocusChangeEvent xfocus; 
XNoExposeEvent xnoexpose; 
XGraphicsExposeEvent xgraphicsexpose; 
XGravityEvent xgravity; 
XKeymapEvent xkeymap; 
XKeyEvent xkey; 
XMapEvent xmap; 
XUnmapEvent xunmap; 
XMappingEvent xmapping; 
XMapRequestEvent xmaprequest; 
XMotionEvent xmotion; 
XPropertyEvent xproperty; 
XReparentEvent xreparent; 
XResizeRequestEvent xresizerequest; 
XSelectionClearEvent xselectionclear; 
XSelectionEvent xselection; 
XSelectionRequestEvent xselectionrequest; 
XVisibilityEvent xvisibility; 


} XEvent; 
typedef struct { 
int type; 
unsigned long serial; /* # of last request processed by server */ 
Bool send event; /* True if this came from SendEvent 
* request */ 
Display *display; /* Display the event was read from */ 
Window window; /* window on which event was requested 


* in event mask */ 
} XAnyEvent; 
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The first member of the XEvent union is the type of event. When an event is received (with 
XNextEvent, for example), the application checks the type member in the XEvent 
union. Then the specific event type is known and the specific event structure (such as 
xbutton) is used to access information specific to that event type. 


Before the branching depending on the event type, only the XEvent union is used. After 
the branching, only the event structure which contains the specific information for each event 
type should be used in each branch. For example, if the XEvent union were called 
report, the report .xexpose structure should be used within the branch for Expose 
events. 


You will notice that each event structure also begins with a type member. This member is 
rarely used, since it is an identical copy of the t ype member in the XEvent union. 


Most event structures also have a window member. The only ones that do not are selection 
events (SelectionClear, SelectionNotify, and SelectionRequest) and 
events selected by the graphics_exposures member of the GC (GraphicsExpose 
and NoExpose). The window member indicates the event window that selected and 
received the event. This is the window where the event arrives if it has propagated through 
the hierarchy as described in Section 8.3.2, of Volume One, Xlib Programming Manual. One 
event type may have two different meanings to an application, depending on which window 
it appears in. 

Many of the event structures also have a display and/or root member. The display 
member identifies the connection to the server that is active. The root member indicates 
which screen the window that received the event is linked to in the hierarchy. Most programs 
only use a single screen and therefore do not need to worry about the root member. The 
display member can be useful, since you can pass the display variable into routines by 
simply passing a pointer to the event structure, eliminating the need for a separate display 
argument. 


All event structures include a serial member that gives the number of the last protocol 
request processed by the server. This is useful in debugging, since an error can be detected 
by the server but not reported to the user (or programmer) until the next routine that gets an 
event. That means several routines may execute successfully after the error occurs. The last 
request processed will often indicate the request that contained the error. 


All event structures also include a send_event flag, which, if True, indicates that the 
event was sent by XSendEvent (i.e., by another client rather than by the server). 


The following pages describe each event type in detail. The events are presented in alphabet- 
ical order, each on a separate page. Each page describes the circumstances under which the 
event is generated, the mask used to select it, the structure itself, its members, and useful pro- 
gramming notes. Note that the description of the structure members does not include those 
members common to many structures. If you need more information on these members, 
please refer to this introductory section. 
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) ButtonPress, ButtonRelease 
—xbutton 


When Generated 
There are two types of pointer button events: ButtonPress and ButtonRelease. Both 
contain the same information. 


Select With 
May be selected separately, using ButtonPressMask and ButtonReleaseMask. 


XEvent Structure Name 
typedef union XEvent { 
XButtonEvent xbutton; 


} XEvent; 


Event Structure 
typedef struct { 


int type; /* of event */ 
unsigned long serial; /* # of last request processed by server */ 
Bool send_event; /* True if this came from a SendEvent request */ 
Display *display; /* Display the event was read from */ 
Window window; /* event window it is reported relative to */ 
Window root; /* root window that the event occurred under */ 
Window subwindow; /* child window */ 
Time time; /* when event occurred, in milliseconds */ 
Ate Vie /* pointer coordinates relative to receiving 

* window */ 
imi xX rOCtye VaLoou, /* coordinates relative to root */ 
unsigned int state; /* mask of all buttons and modifier keys */ 
unsigned int button; /* button that triggered event */ 
Bool same_screen; /* same screen flag */ 


} XButtonEvent; 
typedef XButtonEvent XButtonPressedEvent; 
typedef XButtonEvent XButtonReleasedEvent; 


Event Structure Members 
subwindow If the source window is the child of the receiving window, then the 
subwindow member is set to the ID of that child. 


time The server time when the button event occurred, in milliseconds. Time 
is declared as unsigned long, so it wraps around when it reaches the 
maximum value of a 32-bit number (every 49.7 days). 


xy If the receiving window is on the same screen as the root window speci- 
fied by root, then x and y are the pointer coordinates relative to the 
receiving window’s origin. Otherwise, x and y are zero. 
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ButtonPress, ButtonRelease (continued) xbutton 


When active button grabs and pointer grabs are in effect (see Section 9.4 
of Volume One, Xlib Programming Manual), the coordinates relative to 
the receiving window may not be within the window (they may be nega- 
tive or greater than window height or width). 


x root,y root The pointer coordinates relative to the root window which is an ancestor 
of the event window. If the pointer was on a different screen, these are 
zero. 


state The state of all the buttons and modifier keys just before the event, 
represented by a mask of the button and modifier key symbols: 
ButtonlMask, Button2Mask, Button3Mask, Button4Mask, 
Button5Mask, ControlMask, LockMask, Mod1Mask, Mod2- 
Mask, Mod3Mask, Mod4Mask, Mod5Mask, and ShiftMask. If a 
modifier key is pressed and released when no other modifier keys are 
held, the ButtonPress will have a state member of 0 and the 
ButtonRelease will have a nonzero state member indicating that 
itself was held just before the event. 


button A value indicating which button changed state to trigger this event. One 
of the constants: Buttonl, Button2, Button3, Button4, or 
Buttons. 

same_screen Indicates whether the pointer is currently on the same screen as this win- 


dow. This is always True unless the pointer was actively grabbed 
before the automatic grab could take place. 


Notes 
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Unless an active grab already exists or a passive grab on the button combination that was 
pressed already exists at a higher level in the hierarchy than where the ButtonPress 
occurred, an automatic active grab of the pointer takes place when a ButtonPress occurs. 
Because of the automatic grab, the matching But tonRelease is sent to the same application 
that received the ButtonPress event. If OwnerGrabButtonMask has been selected, the ° 
ButtonRelease event is delivered to the window which contained the pointer when the 
button was released, as long as that window belongs to the same client as the window in which 
the ButtonPress event occurred. If the ButtonRelease occurs outside of the client’s 
windows or OwnerGrabButtonMask was not selected, the ButtonRelease is delivered 
to the window in which the ButtonPress occurred. The grab is terminated when all buttons 
are released. During the grab, the cursor associated with the grabbing window will track the 
pointer anywhere on the screen. 


If the application has invoked a passive button grab on an ancestor of the window in which the 
ButtonPress event occurs, then that grab takes precedence over the automatic grab, and the 
ButtonRelease will go to that window, or it will be handled normally by that client depend- 
ing on the owner events flag in the XGrabButton call. 
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—  xcirculate Cir cu | ate Notify 


When Generated ; 
A CirculateNotify event reports a call to change the stacking order, and it includes 
whether the final position is on the top or on the bottom. This event is generated by 
XCirculateSubwindows, XCirculateSubwindowsDown, or XCirculate- 
SubwindowsUp. See also the CirculateRequest and ConfigureNotify reference 


pages. 


Select With 
This event is selected with StructureNotifyMask in the XSelectInput call for the 
window to be moved or with Subst ructureNotifyMask for the parent of the window to 
be moved. 


XEvent Structure Name 
typedef union XEvent { 


XCirculateEvent xcirculate; 
} XEvent; 


Event Structure 
typedef struct { 


int type; 

unsigned long serial; /* # of last request processed by server */ 
Bool send event; /* True if this came from SendEvent request */ 
Display *display; /* Display the event was read from */ 


Window event; 

Window window; 

int place; /* PlaceOnTop, PlaceOnBottom */ 
} XCirculateEvent; 


Event Structure Members 
event The window receiving the event. If the event was selected by St ructure- 
NotifyMask, event will be the same as window. If the event was selected 
by Subst ructureNotifyMask, event will be the parent of window. 


window The window that was restacked. 


place Either PlaceOnTop or PlaceOnBottom. Indicates whether the window was 
raised to the top or bottom of the stack. 
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Ci rcu late Req uest ee xcirculaterequest— 


When Generated 
A CirculateRequest event reports when XCirculateSubwindows, XCirculate- 
SubwindowsDown, XCirculateSubwindowsUp, or XRestackWindows is called to 


change the stacking order of a group of children. 

This event differs from CirculateNotify in that it delivers the parameters of the request 
before it is carried out. This gives the client that selects this event (usually the window man- 
ager) the opportunity to review the request in the light of its window management policy before 
executing the circulate request itself or to deny the request. (CirculateNotify indicates 
the final outcome of the request.) 


Select With 
This event is selected for the parent window with Subst ructureRedirectMask. 


XEvent Structure Name 
typedef union XEvent { 


XCirculateRequestEvent xcirculaterequest; 
} XEvent; 


Event Structure 
typedef struct { 


int type; 

unsigned long serial; /* # of last request processed by server */ 
Bool send _event; /* True if this came from SendEvent request */ 
Display *display; /* Display the event was read from */ 


Window parent; 

Window window; 

int place; /* PlaceOnTop, PlaceOnBottom */ 
} XCirculateRequestEvent; 


Event Structure Members 
parent The parent of the window that was restacked. This is the window that selected 
the event. 


window The window being restacked. 


place PlaceOnTop or PlaceOnBottom. Indicates whether the window was to be 
placed on the top or on the bottom of the stacking order. 
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—xcllent ClientMessage 


When Generated 
A ClientMessage event is sent as a result of a call to XSendEvent by a client to a particu- 
lar window. Any type of event can be sent with XSendEvent, but it will be distinguished 
from normal events by the send_event member being set to True. If your program wants to 
be able to treat events sent with XSendEvent as different from normal events, you can read 


this member. 


‘Select With 
There is no event mask for ClientMessage events, and they are not selected with 
XSelectInput. Instead XSendEvent directs them to a specific window, which is given as 
a window ID: the PointerWindow or the InputFocus. : 


XEvent Structure Name 
typedef union XEvent { 


XClientMessageEvent xclient; 
} XEvent; 


Event Structure 
typedef struct { 


int type; 

unsigned long serial; /* # of last request processed by server */ 
Bool send_ event; /* True if this came from SendEvent request */ 
Display *display; /* Display the event was read from */ 


Window window; 

Atom message type; 

int format; 

union { 
Char bii20 1+ 
short s[10]; 
Hong Lil + 

} data; 

} XClientMessageEvent; 


Event Structure Members 
message_type An atom that specifies how the data is to be interpreted by the receiving 
client. The X server places no interpretation on the type or the data, but 
it must be a list of 8-bit, 16-bit, or 32-bit quantities, so that the X server 
can correctly swap bytes as necessary. The data always consists of 
twenty 8-bit values, ten 16-bit values, or five 32-bit values, although 
each particular message might not make use of all of these values. 


format Specifies the format of the property specified by message_type. This 
will be on of the values 8, 16, or 32. 
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ColormapNotify xcolormap— 


When Generated 
A ColormapNotify event reports when the colormap attribute of a window changes or 
when the colormap specified by the attribute is installed, uninstalled, or freed. This event is 
generated by XChangeWindowAttributes, XFreeColormap, XInstallColormap, 
and XUninstallColormap. 


Select With 
This event is selected with ColormapChangeMask. 


XEvent Structure Name 
typedef union XEvent { 


XColormapEvent xcolormap; 
} XEvent; 


Event Structure 
typedef struct { 


int type; 

unsigned long serial; /* # of last request processed by server */ 
Bool send _ event; /* True if this came from SendEvent wequest */ 
Display *display; /* Display the event was read from */ 

Window window; 

Colormap colormap; /* a colormap or None */ 

Bool new; 

int state; /* ColormapInstalled, ColormapUninstalled */ 


} XColormapEvent; 


Event Structure Members 
window The window whose associated colormap or attribute changes. 


colormap The colormap associated with the window, either a colormap ID or the constant 
None. It will be None only if this event was generated due to an XFree- 


Colormap call. 

new True when the colormap attribute has been changed, or False when the color- 
map is installed or uninstalled. 

state Either ColormapInstalled or ColormapUninstalled; it indicates 


whether the colormap is installed or uninstalled. 


~ 
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elvesrtgure ) ConfigureNotify 


When Generated , 
A ConfigureNotify event announces actual changes to a window’s configuration (size, 


position, border, and stacking order). See also the CirculateRequest reference page. 


Select With 
This event is selected for a single window by specifying the window ID of that window with 
StructureNotifyMask. To receive this event for all children of a window, specify the 


parent window ID with Subst ructureNotifyMask. 


XEvent Structure Name 
_ typedef union XEvent { 


XConfigureEvent xconfigure; 
} XEvent; 


Event Structure 
typedef struct { 


int type; 

unsigned long serial; /* # of last request processed by server */ 
Bool send event; /* True if this came from SendEvent request */ 
Display *display; /* Display the event was read from */ 


Window event; 

Window window; 

Ie x Ys 

int width, height; 

int border width; 

Window above; 

BoolVovernidemredirect; 
} XConfigureEvent; 


Event Structure Members 


event The window that selected the event. The event and window 
members are identical if the event was selected with St ructure- 
NotifyMask. 

window The window whose configuration was changed. 

my, The final coordinates of the reconfigured window relative to its par- 
ent. 

width, height The width and height in pixels of the window after reconfiguration. 

border width The width in pixels of the border after reconfiguration. 

above If this member is None, then the window is on the bottom of the 


stack with respect to its siblings. Otherwise, the window is immedi- 
ately on top of the specified sibling window. 
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ConfigureNotify (continued) xconfigure 


override redirect The override redirect attribute of the reconfigured window. 
If True, it indicates that the client wants this window to be immune 
to interception by the window manager of configuration requests. 
Window managers normally should ignore this event if 
override redirect is True. 
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— xconfigurerequest Co nfigure Request 


When Generated 
A ConfigureRequest event reports when another client attempts to change a window’s 


size, position, border, and/or stacking order. 

This event differs from ConfigureNotify in that it delivers the parameters of the request 
before it is carried out. This gives the client that selects this event (usually the window man- 
ager) the opportunity to revise the requested configuration before executing the 
XConfigureWindow request itself or to deny the request. (ConfigureNotify indicates 
the final outcome of the request.) 


Select With 
This event is selected for any window in a group of children by specifying the parent window 
with Subst ructureRedirectMask. 


XEvent Structure Name 
typedef union XEvent { 


XConfigureRequestEvent xconfigurerequest; 
} XEvent; 


Event Structure 
typedef struct { 


int type; 

unsigned long serial; /* # of last request processed by server */ 
Bool send _event; /* True if this came from SendEvent request */ 
Display *display; /* Display the event was read from */ 


Window parent; 
Window window; 
aN ey Ve 
int width, height; 
int border width; 
Window above; 
int detail; /* Bbove, Below, BottomIf, TopIf, Opposite */ 
unsigned long value_mask; 
} XConfigureRequestEvent; 


Event Structure Members 


parent The window that selected the event. This is the parent of the window 
being configured. 
window The window that is being configured. 


X,Y The requested position for the upper-left pixel of the window’s border 
relative to the origin of the parent window. 


width, height The requested width and height in pixels for the window. 
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ConfigureRequest (continued) xconfigurerequest 


border width The requested border width for the window. 


above None, Above, Below, TopIf, BottomIf, or Opposite. Specifies 
the sibling window on top of which the specified window should be 
placed. If this member has the constant None, then the specified win- 
dow should be placed on the bottom. 


Notes 
The geometry is derived from the XConfigureWindow request that triggered the event. 
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—xcreatewindow CreateNotify 


When Generated 


A CreateNotify event reports when a window is created. 


Select With 
This event is selected on 


children of a window by specifying the parent window ID with 


SubstructureNotifyMask. (Note that this event type cannot be selected by 
StructureNotifyMask.) 


-XEvent Structure Name 
typedef union XEvent 


{ 


XCreateWindowEvent xcreatewindow; 


} XEvent; 


Event Structure 
typedef struct { 
int type; 


unsigned long serial; /* # of last request processed by server */ 


Bool send _ event; 


Display *display; 
Window parent; 
Window window; 
Lin mea peyie 

int width, height 
int border width; 


/* True if this came from SendEvent 
* request */ 
/* Display the event was read from */ 
/* parent of the window */ 
/* window ID of window created */ 
/* window location */ 
5 /* size of window */ 
/* border width */ 


Bool override redirect; /* creation should be overridden */ 


} XCreateWindowEvent; 


Event Structure Members 
parent 


window 

x,y 

width, height 
border width 


override redirect 
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The ID of the created window’s parent. 

The ID of the created window. 

The coordinates of the created window relative to its parent. 
The width and height in pixels of the created window. 

The width in pixels of the border of the created window. 


The override redirect attribute of the created window. If 
True, it indicates that the client wants this window to be immune 
to interception by the window manager of configuration requests. 
Window managers normally should ignore this event if 
override redirect is True. 
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CreateNotify (continued) xcreatewindow 


Notes 
For descriptions of these members, see the XCreateWindow function and the xSet- 
WindowAttributes structure. 
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— xdestroywindow————————" DestroyNotify 


When Generated é 
A Dest royNotify event reports that a window has been destroyed. 


Select With 
To receive this event type on children of a window, specify the parent window ID and pass 


SubstructureNotifyMask as part of the event_mask argument to XSelect Input. 
This event type cannot be selected with St ructureNotifyMask. 


XEvent Structure Name 
typedef union XEvent { 


XDestroyWindowEvent xdestroywindow; 
} XEvent; 


Event Structure 

typedef struct { 
int type; 
unsigned long serial; /* # of last request processed by server */ 
Bool send event; /* True if this came from SendEvent request */ 
Display *display; /* Display the event was read from */ 
Window event; 
Window window; 

} XDestroyWindowEvent; 


Event Structure Members 
event The window that selected the event. 


window The window that was destroyed. 
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EnterNotify, LeaveNotify xcrossing— 


When Generated 
EnterNotify and LeaveNotify events occur when the pointer enters or leaves a window. 


When the pointer crosses a window border, a LeaveNotify event occurs in the window 
being left and an EnterNotify event occurs in the window being entered. Whether or not 
each event is queued for any application depends on whether any application selected the right 
event on the window in which it occurred. 


In addition, EnterNotify and LeaveNotify events are delivered to windows that are 
virtually crossed. These are windows that are between the origin and destination windows in 
the hierarchy but not necessarily on the screen. Further explanation of virtual crossing is pro- 
vided two pages following. 


Select With 
Each of these events can be selected Seen with XEnterWindowMask and XLeave- 
WindowMask. 


XEvent Structure Name 
typedef union XEvent { 


XCrossingEvent xcrossing; 


} XEvent; 


Event Structure 
typedef struct { 


int type; /* of event */ 
unsigned long serial; /* # of last request processed by server */ 
Bool send_event; /* True if this came from SendEvent request */ 
Display *display; /* Display the event was read from */ 
Window window; /* event window it is reported relative to */ 
Window root; /* root window that the event occurred on */ 
Window subwindow; /* child window */ 
Time time; /* milliseconds */ 
NDC me pen Vie /* pointer x,y coordinates in receiving 

* window */ 
UMEXeEOOk, yiGOOr, /* coordinates relative to root */ 
int mode; /* NotifyNormal, NotifyGrab, NotifyUngrab */ 
int detail; /* NotifyAncestor, NotifyInferior, 


* NotifyNonLinear, NotifyNonLinearVirtual, 
* NotifyVirtual */ 


Bool same_screen; /* same screen flag */ 
Bool focus; /* boolean focus */ 
unsigned int state; /* key or button mask */ 


} XCrossingEvent; 
typedef XCrossingEvent XEnterWindowEvent; 
typedef XCrossingEvent XLeaveWindowEvent; 
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xcrossing 


(continued) EnterNotify, LeaveNotify 


Event Structure Members 
The following list describes the members of thé XCrossingEvent structure. 


subwindow 


time 


SOV; 
x_root,y root 


mode 


detail 


same_screen 


focus 


state 


In a LeaveNotify event, if the pointer began in a child of the receiv- 
ing window, then the child member is set to the window ID of the 
child. Otherwise, it is set to None. For an EnterNotify event, if the 
pointer ends up in a child of the receiving window, then the child 
member is set to the window ID of the child. Otherwise, it is set to 
None. 


The server time when the crossing event occurred, in milliseconds. 
Time is declared as unsigned long, so it wraps around when it 
reaches the maximum value of a 32-bit number (every 49.7 days). 


The point of entry or exit of the pointer relative to the event window. 
The point of entry or exit of the pointer relative to the root window. 


Normal crossing events or those caused by pointer warps have mode 
NotifyNormal, events caused by a grab have mode NotifyGrab, 
and events caused by a released grab have mode NotifyUngrab. 


The value of the detail member depends on the hierarchical relation- 
ship between the origin and destination windows and the direction of 
pointer transfer. Determining which windows receive events and with 
which detail members is quite complicated. This topic is described in 
the next section. 


Indicates whether the pointer is currently on the same screen as this win- 
dow. This is always True unless the pointer was actively grabbed 
before the automatic grab could take place. 


If the receiving window is the focus window or a descendant of the focus 
window, the focus member is True; otherwise, it is False. 


The state of all the buttons and modifier keys just before the event, 
represented by a mask of the button and modifier key symbols: 
ButtonlMask, Button2Mask, Button3Mask, Button4Mask, 
Button5Mask, ControlMask, LockMask, Mod1lMask, Mod2- 
Mask, Mod3Mask, Mod4Mask, Mod5Mask, and ShiftMask. 


Virtual Crossing and the detail Member 
Virtual crossing occurs when the pointer moves between two windows that do not have a 
parent-child relationship. Windows between the origin and destination windows in the hierar- 
chy receive EnterNotify and LeaveNotify events. The detail member of each of 
these events depends on the hierarchical relationship of the origin and destination windows and 
the direction of pointer transfer. 
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EnterNotify, LeaveNotify (continued) xcrossing 


618 


Virtual crossing is an advanced topic that you should not spend time figuring out unless you 
have an important reason to use it. We have never seen an application that uses this feature, 
and we know of no reason for its extreme complexity. With that word of warning, proceed. 


Let’s say the pointer has moved from one window, the origin, to another, the destination. First, 
we’ll specify what types of events each window gets and then the detail member of each of 
those events. 


The window of origin receives a LeaveNot ify event and the destination window receives an 
EnterNotify event, if they have requested this type of event. If one is an inferior of the 
other, the detail member of the event received by the inferior is NotifyAncestor and the 
detail of the event received by the superior is NotifyInferior. If the crossing is between 
parent and child, these are the only events generated. 


However, if the origin and destination windows are not parent and child, other windows are 
virtually crossed and also receive events. If neither window is an ancestor of the other, 
ancestors of each window, up to but not including the least common ancestor, receive Leave- 
Notify events, if they are in the same branch of the hierarchy as the origin, and Enter- 
Notify events, if they are in the same branch as the destination. These events can be used to 
track the motion of the pointer through the hierarchy. 


e In the case of a crossing between a parent and a child of a child, the middle child receives a 
LeaveNotify with detail NotifyVirtual. 


e In the case of a crossing between a child and the parent of its parent, the middle child 
receives an EnterNotify with detail NotifyVirtual. 


¢ In a crossing between windows whose least common ancestor is two or more windows 
away, both the origin and destination windows receive events with detail Notify- 
Nonlinear. The windows between the origin and the destination in the hierarchy, up to 
but not including their least common ancestor, receive events with detail Notify- 
NonlinearVirtual. The least common ancestor is the lowest window from which both 
are descendants. 


¢ If the origin and destination windows are on separate screens, the events and details gen- 
erated are the same as for two windows not parent and child, except that the root windows 
of the two screens are considered the least common ancestor. Both root windows also 
receive events. 
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xcrossing 


(continued) EnterNotify, LeaveNotify 


Table E-1 shows the event types generated by a pointer crossing from window A to window B 
when window C is the least common ancestor of A and B. 


Table E-1. Border Crossing Events and Window Relationship 


LeaveNotify 

Origin window (A) 
Windows between A and B, 
exclusive, if A is inferior 


Windows between A and C, 
exclusive 


Root window on screen of 
origin if different from 
screen of destination 





EnterNotify 
Destination window (B) 
Windows between A and B, exclusive, if B is inferior 


Windows between B and C, exclusive, 


Root window on screen of destination if different 
from screen of origin 


Table E-2 lists the detail members in events generated by a pointer crossing from window A 


to window B. 


Table E-2. Event detail Member and Window Relationship 


detail Flag 
NotifyAncestor 
NotifyInferior 


NotifyVirtual 
NotifyNonlinear 


NotifyNonlinearVirtual 
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Window Delivered To 
Origin or destination when either is descendant 
Origin or destination when either is ancestor 


Windows between A and B, exclusive, if either is 
descendant 


Origin and destination when A and B are two or more 
windows distant from least common ancestor C 


Windows between A and C, exclusive, and between 
B and C, exclusive, when A and B have least common 
ancestor C; also on both root windows if A and B are 
on different screens 
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EnterNotify, LeaveNotify (continued) xcrossing 


620 


For example, Figure E-1 shows the events that are generated by a movement from a window 
(window A) to a child (window B/) of a sibling (window B). This would generate three events: 
a LeaveNotify with detail Not ifyNonlinear for the window A, an EnterNotify with 
detail NotifyNonlinearVirtual for its sibling window B, and an EnterNotify with 
detail Not ifyNonlinear for the child (window B/). 









Root Window 


(no event) 













EnterNotify event with detail 
NotifyNonlinearVirtual 






A 


LeaveNotify event with detail 
NotifyNonlinear 





B1 


no event EnterNotify event with detail 
NotifyNonlinear 















Figure E-1. Events generated by a move between windows 


EnterNotify and LeaveNotify events are also generated when the pointer is grabbed, if 
the pointer was not already inside the grabbing window. In this case, the grabbing window 
receives an EnterNotify and the window containing the pointer receives a LeaveNotify 
event, both with mode NotifyUngrab. The pointer position in both events is the position 
before the grab. The result when the grab is released is exactly the same, except that the two 
windows receive EnterNotify instead of LeaveNotify and vice versa. 
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(continued) 


EnterNotify, LeaveNotify 


Figure E-2 demonstrates the events-and details caused by various pointer transitions, indicated 


by heavy arrows. 


EnterNotify, 
Inferior 


LeaveNotify, 
Virtual 


LeaveNotify, 
Ancestor 





EnterNotify, 
Inferior 


LeaveNotify, 
Virtual 


LeaveNotify, 
Ancestor 












LeaveNotify, 


LeaveNotify, 
NonLinearVirtual 


NonLinearVirtual 


LeaveNotify, EnterNotify, 
NonLinear 


NonLinear 





LeaveNotify, 


LeaveNotify, 
NonLinearVirtual NonLinearVirtual 
LeaveNotify, EnterNotify, 


NonLinear NonLinear 





Figure E-2. Border crossing events and detail member for pointer movement from 
window A to window B, for various window relationships 
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Expose ————— 


When Generated 
An Expose event is generated when a window becomes visible or a previously invisible part 
of a window becomes visible. Only InputOutput windows generate or need to respond to 
Expose events; InputOnly windows never generate or need to respond to them. The 
Expose event provides the position and size of the exposed area within the window and a 
rough count of the number of remaining exposure events for the current window. 


Select With 
This event is selected with ExposureMask. 


XEvent Structure Name 
typedef union XEvent { 


XExposeEvent xexpose; 
} XEvent; 


Event Structure 
typedef struct { 


int type; 

unsigned long serial; /* # of last request processed by server */ 
Bool send_event; /* True if this came from SendEvent request */ 
Display *display; /* Display the event was read from */ 


Window window; 

Nita op ay, 

int width, height; 

int count; /* If nonzero, at least this many more */ 
} XExposeEvent; 


Event Structure Members 


x,y The coordinates of the upper-left corner of the exposed region relative to 
the origin of the window. 


width, height The width and height in pixels of the exposed region. 


count The approximate number of remaining contiguous Expose events that 
were generated as a result of a single function call. 


Notes 
A single action such as a window movement or a function call can generate several exposure 
events on one window or on several windows. The server guarantees that all exposure events 
generated from a single action will be sent contiguously, so that they can all be handled before 
moving on to other event types. This allows an application to keep track of the rectangles 
specified in contiguous Expose events, set the clip_mask ina GC to the areas specified in 
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xexpose (continued) Expose 
the rectangle using XSet Region or XSetClipRectangles, and then finally redraw the 
window clipped with the GC in a single operation after all the Expose events have arrived. 
The last event to arrive is indicated by a count of 0. In Release 2, XUnionRectWith- 
Region can be used to add the rectangle in Expose events to a region before calling xSet - 
Region. 

If your application is able to redraw partial windows, you can also read each exposure event in 
turn and redraw each area. 
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Focusin, FocusOut nicelie— 


When Generated 
FocusiIn and FocusOut events occur when the keyboard focus window changes as a result 
of an XSetInputFocus call. They are much like EnterNotify and LeaveNotify 
events except that they track the focus rather than the pointer. 


When a focus change occurs, a FocusOut event is delivered to the old focus window and a 
FocusIn event to the window which receives the focus. In addition, windows in between 
these two windows in the window hierarchy are virtually crossed and receive focus change 
events, as described below. Some or all of the windows between the window containing the 
pointer at the time of the focus change and the root window also receive focus change events, 
as described below. 


Select With 
FocusIn and FocusOut events are selected with FocusChangeMask. They cannot be 
selected separately. ; 


XEvent Structure Name 
typedef union XEvent { 


XFocusChangeEvent xfocus; 
(ars: 
} XEvent; 


Event Structure 
typedef struct { 


int type; /* FocusIn or FocusOut */ 

unsigned long serial; /* # of last request processed by server */ 
Bool send _event; /* True if this came from SendEvent request */ 
Display *display; /* Display the event was read from */ 

Window window; /* Window of event */ 

int mode; /* NotifyNormal, NotifyGrab, NotifyUngrab */ 
int detail; /* NotifyAncestor, NotifyDetailNone, 


* NotifylInferior, NotifyNonLinear, 
* NotifyNonLinearVirtual, NotifyPointer, 
* NotifyPointerRoot, NotifyVirtual*/ 

} XFocusChangeEvent; 

typedef XFocusChangeEvent XFocusInEvent; 

typedef XFocusChangeEvent XFocusOutEvent; 


Event Structure Members 
mode For events generated when the keyboard is not grabbed, mode is Notify- 
Normal; when the keyboard is grabbed, mode is NotifyGrab; and when a 
keyboard is ungrabbed, mode is Not ifyUngrab. 


detail The detail member identifies the relationship between the window that 
receives the event and the origin and destination windows. It will be described 
in detail after the description of which windows get what types of events. 
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Notes 
The keyboard focus is a window that has been designated as the one to receive all keyboard 
input irrespective of the pointer position. Only the keyboard focus window and its descendants 
receive keyboard events. By default, the focus window is the root window. Since all windows 
are descendants of the root, the pointer controls the window that receives input. 


Most window managers allow the user to set a focus window to avoid the problem where the 
pointer sometimes gets bumped into the wrong window and your typing does not go to the 
intended window. If the pointer is pointing at the root window, all typing is usually lost, since 
there is no application for this input to propagate to. Some applications may set the keyboard 
focus so that they can get all keyboard input for a given period of time, but this practice is not 
encouraged. 


Focus events are used when an application wants to act differently when the keyboard focus is 
set to another window or to itself. FocusChangeMask is used to select FocusIn and 
FocusOut events. 


When a focus change occurs, a FocusOut event is delivered to the old focus window and a 
FocuslIn event is delivered to the window which receives the focus. Windows in between in 
the hierarchy are virtually crossed and receive one focus change event each depending on the 
relationship and direction of transfer between the origin and destination windows. Some or all 
of the windows between the window containing the pointer at the time of the focus change and 
that window’s root window can also receive focus change events. By checking the detail 
member of FocusIn and FocusOut events, an application can tell which of its windows can 
receive input. 


The detail member gives clues about the relationship of the event receiving window to the 
origin and destination of the focus. The detail member of FocusIn and FocusOut events 
is analogous to the detail member of EnterNotify and LeaveNotify events but with 
even more permutations to make life complicated. 


Virtual Focus Crossing and the detail Member 
We will now embark on specifying the types of events sent to each window and the detail 
member in each event, depending on the relative position in the hierarchy of the origin window 
(old focus), destination window (new focus), and the pointer window (window containing 
pointer at time of focus change). Don’t even try to figure this out unless you have to. 
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(continued) 


xfocus 


Table E-3 shows the event types generated by a focus transition from window A to window B 
when window C is the least common ancestor of A and B. This table includes most of the 
events generated, but not all of them. It is quite possible for a single window to receive more 
than one focus change event from a single focus change. 


Table E-3. Focusin and FocusOut Events and Window Relationship 


FocusOut 
Origin window (A) 


Windows between A and B, 
exclusive, if A is inferior 


Windows between A and C, 
exclusive 


Root window on screen of 
origin if different from 
screen of destination 


Pointer window up to but 
not including origin window 
if pointer window is descen- 
dant of origin 


Pointer window up to and 
including pointer window’s 
root if transfer was from 
PointerRoot 





FocusIn 
Destination window (B) 
Windows between A and B, exclusive, if B is inferior 


Windows between B and C, exclusive 


Root window on screen of destination if different 
from screen of origin 


Pointer window up to but not including destination 
window if pointer window is descendant of destina- 
tion 


Pointer window up to and including pointer win- 
dow’s root if transfer was to PointerRoot 
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(continued) FocusIn, FocusOut 


Table E-4 lists the det ail members in events generated by a focus transition from window A 
to window B when window C is the least common ancestor of A and B, with P being the win- 


dow containing the pointer. 


Table E-4. Event detail Member and Window Relationship 


detail Flag 
NotifyAncestor 
NotifyInferior 


NotifyVirtual 


NotifyNonlinear 


NotifyNonlinearVirtual 


NotifyPointer 


NotifyPointerRoot 


NotifyDetailNone 





Window Delivered To 
Origin or destination when either is descendant 
Origin or destination when either is ancestor 


Windows between A and B, exclusive, if either is 
descendant 


Origin and destination when A and B are two or more 
windows distant from least common ancestor C 


Windows between A and C, exclusive, and between 
B and C, exclusive, when A and B have least common 
ancestor C; also on both root windows if A and B are 
on different screens 


Window P and windows up to but not including the 
origin or destination windows 


Window P and all windows up to its root, and all 
other roots, when focus is set to or from Pointer- 
Root 


All roots, when focus is set to or from None 


Figure E-3 shows all the possible combinations of focus transitions and of origin, destination, 
and pointer windows and shows the types of events that are generated and their detail mem- 
ber. Solid lines indicate branches of the hierarchy. Dotted arrows indicate the direction of 
transition of the focus. At each end of this arrow are the origin and destination windows, win- 
dows A to B. Arrows ending in a bar indicate that the event type and detail described are 
delivered to all windows up to the bar. 


In any branch, there may be windows that are not shown. Windows in a single branch between 
two boxes shown will get the event types and details shown beside the branch. 


Xlib Reference Manual 


627 


~ 
oo 
= 
i) 
on 
i 
—} 
° 
Co 


an 
Aa 
< 
ae} 
ot 
| 
oa 





Focusin, FocusOut 


EnterNotify, 
Inferior 


LeaveNotify, 
Virtual 


LeaveNotify, 






<M If window P is between A 
and B, windows from P up 
to but not including B get 
Focus in with detail 


(continued) 


xfocus 


EnterNotify, 
Inferior 


LeaveNotify, 
Virtual 


LeaveNotify, FocusOut, 








Ancestor NotifyInterior Ancestor Pointer 
Roots of other Screens: 
. FocusIn with Detail PointerRoot 
FocusiIn, 
PointerRoot 
FoecusOut, FocusiIn, 


NonLinearVirtual 





NonLinearVirtual 


Focusin, 









FocusOut, ; h 
NonLinear NonLinear BOCES OME 
NonLinearVirtual 
FocusOut, Focusin, 
Pointer Pointer FocusOut, 
Pointer 
Roots of other Screens: 
FocusIn with Detail None 
FocusOut, FocusIin, 
NonLinearVirtual NonLinearVirtual FocusIn, 
None 
FocusOut, FocusIn, 
NonLinear NonLinear FocusOut, 


Figure E-3. 
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FocusIn, 
Pointer 









NonLinearVirtual 


FocusOut, 
Pointer 


Focus/n and FocusOut event schematics 
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Roots of other Screens: 
FocusOut with Detail PointerRoot 


Focusin, 
NonLinearVirtual 
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(continued) 


Focusin, FocusOut 


Roots of other Screens: 
FocusOut with Detail None 


FocusIin, 
NonLinearVirtual 
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FocusiIn, 
NonLinear 
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FocusIn, 
Pointer 








===—> Focus change from PointerRoot to None 


All Root Windows: 
FocusOut with Detail PointerRoot 







Pointers ae 
Root Window _ 








===> Focus change from PointerRoot to None 


All Root Windows: 
FocusOut with Detail None 


Focusin, 
PointerRoot 





Figure E-3. Focusln and FocusOut event schematics (cont.) 


FocusIn and FocusOut events are also generated when the keyboard is grabbed, if the focus 
was not already assigned to the grabbing window. In this case, all windows receive events as if 
the focus was set from the current focus to the grab window. When the grab is released, the 


events generated are just as if the focus was set back. 
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GraphicsExpose, NoExpose xriosilpaitaieee 


When Generated 


GraphicsExpose events indicate that the source area fora XCopyArea or XCopyPlane 
request was not available because it was outside the source window or obscured by a window. 
NoExpose events indicate that the source region was completely available. 


Select With 


These events are not selected with XSelectInput but are sent if the GC in the XCopyArea 
or XCopyPlane request had its graphics_exposures flag set to True. If 
graphics exposures is True in the GC used for the copy, either one NoExpose event 
or one or more GraphicsExpose events will be generated for every XCopyArea or 


XCopyP lane call made. 


XEvent Structure Name 
typedef union XEvent { 


XNoExposeEvent xnoexpose; 


XGraphicsExposeEvent xgraphicsexpose; 


} XEvent; 


Event Structure 
typedef struct { 
int type; 


unsigned long serial; 


Bool send event; 
Display *display; 
Drawable drawable; 
ait eye 
int width, height; 
int count: 
int major code; 
int minor _code; 

} XGraphicsExposeEvent; 


typedef struct { 
int type; 
unsigned long serial; 
Bool send event; 
Display *display; 
Drawable drawable; 
int major code; 
int minor code; 

} XNoExposeEvent; 
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/* 
/* 
/* 


/* 
/* 
/* 


/* 
/* 
/* 


/* 
/* 


# of last request processed by server */ 
True if this came from SendEvent request */ 
Display the event was read from */ 


if nonzero, at least this many more */ 
core is CopyArea or CopyPlane */ 
not defined in the core */ 


# of last request processed by server */ 
True if this came from SendEvent request */ 
Display the event was read from */ 


core is CopyArea or CopyPlane */ 
not defined in the core */ 
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(continued) GraphicsExpose, NoExpose 


Event Structure Members 


drawable 


x, V 


width, height 


count 


major code 


minor code 


Notes 


A window or an off-screen pixmap. This specifies the destination of the 
graphics request that generated the event. 


The coordinates of the upper-left corner of the exposed region relative to 
the origin of the window. 


The width and height in pixels of the exposed region. 


The approximate number of remaining contiguous GraphicsExpose 
events that were generated as a result of the XCopyArea or XCopy- 
Plane call. 


The graphics request used. This may be one of the symbols CopyArea 
or CopyP lane or a symbol defined by a loaded extension. 


Zero unless the request is part of an extension. 


Expose events and GraphicsExpose events both indicate the region of a window that was 
actually exposed (x, y, width, and height). Therefore, they can often be handled similarly. 
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GravityNotify xgravity— 


When Generated 
A GravityNotify event reports when a window is moved because of a change in the size of 


its parent. This happens when the win_gravity attribute of the child window is something 
other than StaticGravity or UnmapGravity. 


Select With 
This event is selected for a single window by specifying the window ID of that window with 
StructureNotifyMask. To receive notification of movement due to gravity for a group of 
siblings, specify the parent window ID with Subst ructureNotifyMask. 


XEvent Structure Name 
typedef union XEvent { 


XGravityEvent xgravity; 
} XEvent; 


Event Structure 
typedef struct { 


int type; 

unsigned long serial; /* # of last request processed by server */ 
Bool send_event; /* True if this came from SendEvent request */ 
Display *display; /* Display the event was read from */ 


Window event; 
Window window; 
any eee Vo 

} XGravityEvent; 


Event Structure Members 


event The window that selected the event. 
window The window that was moved. 
xy The new coordinates of the window relative to its parent. 
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—xkeymap KeymapNotify 


When Generated 
A KeymapNotify event reports the state of the keyboard and occurs when the pointer or 
keyboard focus enters a window. KeymapNotify events are reported immediately after 
EnterNotify or FocusIn events. This is a way for the application to read the keyboard 
state as the application is “woken up,” since the two triggering events usually indicate that the 
application is about to receive user input. 


Select With 
This event is selected with KeymapStateMask. 


XEvent Structure Name 
typedef union XEvent { 


XKeymapEvent xkeymap; 
} KEvent; 


Event Structure 
typedef struct { 


int’ type; 

unsigned long serial; /* # of last request processed by server */ 
Bool send event; /* True if this came from SendEvent request */ 
Display *display; /* Display the event was read from */ 


Window window; 
char key vector[32]; 
} XKeymapEvent; 


Event Structure Members 
window Reports the window which was reported in the window member of the pre- 


ceding EnterNotify or FocusIn event. 


key vector A bit vector or mask, each bit representing one physical key, with a total of 
256 bits. For a given key, its keycode is its position in the keyboard vector. | 
You can also get this bit vector by calling XQueryKeymap. | 





Notes | 
The serial member of KeymapNotify does not contain the serial number of the most | 
recent protocol request processed, because this event always follows immediately after 
EnterNotify or FocusIn events in which the serial member is valid. 
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KeyPress, KeyRelease xkey— 


When Generated 
KeyPress and KeyRelease events are generated for all keys, even those mapped to 
modifier keys such as Shift or Control. 


Select With 
Each type of keyboard event may be selected separately with KeyPressMask and Key~ 
ReleaseMask. 


XEvent Structure Name 
typedef union XEvent { 
XKeyEvent xkey; 


} XEvent; 


Event Structure 
typedef struct { 


int type; /* of event */ 

unsigned long serial; /* # of last request processed by server */ 

Bool send event; /* True if this came from SendEvent request */ 

Display *display; /* Display the event was read from */ 

Window window; /* event window it is reported relative to */ 

Window root; /* root window that the event occurred on */ 

Window subwindow; /* child window */ 

Time time; /* milliseconds */ 

ies ayer /* pointer coordinates relative to receiving 
x window */ 

int x_root, y root; /* coordinates relative to root */ 

unsigned int state; /* modifier key and button mask */ 

unsigned int keycode; /* server-dependent code for key */ 

Bool same_screen; /* same screen flag */ 


} XKeyEvent; 
typedef XKeyEvent XKeyPressedEvent; 
typedef XKeyEvent XKeyReleasedEvent; 


Event Structure Members 
subwindow If the source window is the child of the receiving window, then the 
subwindow member is set to the ID of that child. 


time The server time when the button event occurred, in milliseconds. Time 
is declared as unsigned long, so it wraps around when it reaches the 
maximum value of a 32-bit number (every 49.7 days). 


x,Y If the receiving window is on the same screen as the root window speci- 
fied by root, then x and y are the pointer coordinates relative to the 
receiving window’s origin. Otherwise, x and y are zero. 
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xkey (continued) KeyPress, KeyRelease 


When active button grabs and pointer grabs are in effect (see Section 9.4 
of Volume One, Xlib Programming Manual), the coordinates relative to 
the receiving window may not be within the window (they may be nega- 
tive or greater than window height or width). 


x_root,y root The pointer coordinates relative to the root window which is an ancestor 
of the event window. If the pointer was on a different screen, these are 
zero. 


state The state of all the buttons and modifier keys just before the event, 
represented by a mask of the button and modifier key symbols: 
ButtonlMask, Button2Mask, Button3Mask, Button4Mask, 
Button5Mask, ControlMask, LockMask, Mod1lMask, Mod2- 
Mask, Mod3Mask, Mod4Mask, Mod5Mask, and ShiftMask. 


keycode The keycode member contains a server-dependent code for the key that 
changed state. As such, it should be translated into the portable symbol 
called a keysym before being used. It can also be converted directly into 
ASCII with XLookupSt ring. For a description and examples of how 
to translate keycodes, see Volume One, Section 9.1.1. 


Notes 
Remember that not all hardware is capable of generating release events and that only the main 
keyboard (a-z, A-Z, 0-9), Shift, and Control keys are always found. 


Keyboard events are analogous to button events, though, of course, there are many more keys 
than buttons and the keyboard is not automatically grabbed between press and release. 


All the structure members have the same meaning as described for ButtonPress and 
ButtonRelease events, except that button is replaced by keycode. 
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MapNotify, UnmapNotify xmap; xuniniai— 


When Generated 
The X server generates MapNot ify and UnmapNot ify events when a window changes state 


from unmapped to mapped or vice versa. 


Select With 
To receive these events on a single window, use StructureNotifyMask in the call to 


XSelectInput for the window. To receive these events for all children of a particular 
parent, specify the parent window ID and use Subst ructureNotifyMask. 


XEvent Structure Name 
typedef union XEvent { 


XMapEvent xmap; 
XUnmapEvent xunmap; 


} XEvent; 


Event Structure 
typedef struct { 


int type; 

unsigned long serial; /* # of last request processed by server */ 
Bool send event; /* True if this came from SendEvent request */ 
Display *display; /* Display the event was read from */ 


Window event; 
Window window; 
Bool override redirect;  /* boolean, is override set */ 


} XMapEvent; 

typedef struct { 
int type; 
unsigned long serial; /* # of last request processed by server */ 
Bool send_event; /* True if this came from SendEvent request */ 
Display *display; /* Display the event was read from */ 


Window event; 

Window window; 

Bool from_configure; 
} XUnmapEvent; 


Event Structure Members 
event The window that selected this event. 


window The window that was just mapped or unmapped. 


override redirect (XMapEvent only) 
True or False. The value of the override redirect attribute of the 
window that was just mapped. 
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xmap, xunmap (continued) MapNotify, UnmapNotify 


from_configure (xUnmapEvent only) : 
True if the event was generated as a result of a resizing of the window’s parent 


when the window itself had a win_gravity of UnmapGravity. See the 
description of the win_gravity attribute in Section 4.3.4 of Volume One, 


Xlib Programming Manual. False otherwise. 
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MappingNotify xmapping— 


When Generated 

A MappingNotify event is sent when any of the following is changed by another client: the 
mapping between physical keyboard keys (keycodes) and keysyms, the mapping between 
modifier keys and logical modifiers, or the mapping between physical and logical pointer 
buttons. These events are triggered by a call to XSetModifierMapping or XSet- 
PointerMapping, if the return status is MappingSuccess, or by any call to XChange- 
KeyboardMapping. 

This event type should not be confused with the event that occurs when a window is mapped; 
that is a MapNotify event. Nor should it be confused with the KeymapNotify event, 
which reports the state of the keyboard as a mask instead of as a keycode. 


Select With 
The X server sends MappingNotify events to all clients. It is never selected and cannot be 
masked with the window attributes. 


XEvent Structure Name 
typedef union XEvent { 


XMappingEvent xmapping; 


} XEvent; 


Event Structure 

typedef struct { 
int type; 
unsigned long serial; /* # of last request processed by server */ 
Bool send event; /* True if this came from SendEvent request */ 
Display *display; /* Display the event was read from */ 
Window window; /* unused */ 
int request; /* one of MappingMapping, MappingKeyboard, 

* MappingPointer */ 

int first_keycode; /* first keycode */ 
InER Count. /* range of change with first keycode*/ 

} XMappingEvent; = 


Event Structure Members 
request The kind of mapping change that occurred: MappingModifier fora 
successful XSetModifierMapping (keyboard Shift, Lock, Control, 
Meta keys), MappingKeyboard for a_ successful xChange- 
KeyboardMapping (other keys), and MappingPointer for a suc- 
cessful XSet PointerMapping (pointer button numbers). 


first_keycode If the request member is MappingKeyboard or Mapping- 
Modifier, then first_keycode indicates the first in a range of key- 
codes with altered mappings. Otherwise, it is not set. 
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- xmapping (continued) MappingNotify 


count If the request member is MappingKeyboard or Mapping- 
Modifier, then count indicates the number of keycodes with altered 


mappings. Otherwise, it is not set. 


Notes 

If the request member is MappingKeyboard, clients should call xRef reshKeyboard- 
Mapping. 

The normal response to a request member of MappingPointer or MappingModifier 
is no action. This is because the clients should use the logical mapping of the buttons and 
modifiers to allow the user to customize the keyboard if desired. If the application requires a 
particular mapping regardless of the user’s preferences, it should call xGetModifier- 
Mapping or XGetPointerMapping to find out about the new mapping. 
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Map Request xmaprequest — 


When Generated 
A MapRequest event occurs when the functions XMapRaised and XMapWindow are 


called. 

This event differs from MapNotify in that it delivers the parameters of the request before it is 
carried out. This gives the client that selects this event (usually the window manager) the 
opportunity to revise the size or position of the window before executing the map request itself 
or to deny the request. (MapNot ify indicates the final outcome of the request.) 


Select With 
This event is selected by specifying the window ID of the parent of the receiving window with 
Subst ructureRedirectMask. (In addition, the override redirect member of the 
XSetWindowAttributes structure for the specified window must be False.) 


XEvent Structure Name 
typedef union XEvent { 


XMapRequestEvent xmaprequest; 
} XEvent; 


Event Structure 
typedef struct { 


int type; 

unsigned long serial; /* # of last request processed by server */ 
Bool send _ event; /* True if this came from SendEvent request */ 
Display *display; /* Display the event was read from */ 


Window parent; 
Window window; 
} XMapRequestEvent; 


Event Structure Members 
parent The ID of the parent of the window being mapped. 


window The ID of the window being mapped. 
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—xmotion MotionNotify 


When Generated ; 
A MotionNotify event reports that the user moved the pointer or that a program warped the 
pointer to a new position within a single window. 


Select With 
This event is selected with ButtonMotionMask, ButtonlMotionMask, Button2- 
MotionMask, Button3MotionMask, Button4MotionMask, Button5MotionMask, 
PointerMotionHintMask, and PointerMotionMask. These masks determine the spe- 
cific conditions under which the event is generated. 


See Section 8.3.3.3 of Volume One, Xlib Programming Manual, for a description of selecting 
button events. 


XEvent Structure Name 
typedef union XEvent { 





XMotionEvent xmotion; 
} XEvent; 


Event Structure 
typedef struct { 
int type; /* of event */ 
unsigned long serial; /* # of last request processed by server */ 
Bool send event; /* True if this came from SendEvent request */ 


Display *display; 
Window window; 
Window root; 
Window subwindow; 


Display the event was read from */ 

event window it is reported relative to */ 
root window that the event occurred on */ 
child window */ 


Time time; /* milliseconds */ 

one a, Ve /* pointer coordinates relative to receiving 
* window */ 

int x_root, y root; /* coordinates relative to root */ 

unsigned int state; /* button and modifier key mask */ 

char is_ hint; /xoissthis.a motion shint...%/, 


Bool same_screen; /* same screen flag */ 


} XMotiocnEvent; 
typedef XMotionEvent XPointerMovedEvent; 


Event Structure Members 


subwindow If the source window is the child of the receiving window, then the 
subwindow member is set to the ID of that child. 
time The server time when the button event occurred, in milliseconds. Time 


is declared as unsigned long, So it wraps around when it reaches the 
maximum value of a 32-bit number (every 49.7 days). 
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MotionNotify 


x, Y 


x_root,y root 


state 


is hint 


Same_screen 


Notes 


(continued) xmotion 


If the receiving window is on the same screen as the root window speci- 
fied by root, then x and y are the pointer coordinates relative to the 
receiving window’s origin. Otherwise, x and y are zero. 


When active button grabs and pointer grabs are in effect (see Volume 
One, Section 9.4), the coordinates relative to the receiving window may 
not be within the window (they may be negative or greater than window 
height or width). 


The pointer coordinates relative to the root window which is an ancestor 
of the event window. If the pointer was on a different screen, these are 
zero. 


The state of all the buttons and modifier keys just before the event, 
represented by a mask of the button and modifier key symbols: 
ButtonlMask, Button2Mask, Button3Mask, Button4Mask, 
Button5Mask, ControlMask, LockMask, ModlMask, Mod2- 
Mask, Mod3Mask, Mod4Mask, Mod5Mask, and ShiftMask. 


Either the constant NotifyNormal or NotifyHint. NotifyHint 
indicates that the PointerMotionHintMask was selected. In this 
case, just one event is sent when the mouse moves, and the current posi- 
tion can be found by calling xQueryPointer or by examining the 
motion history buffer with XGetMotionEvents, if a motion history 
buffer is available on the server. NotifyNormal indicates that the 
event is real, but it may not be up to date, since there may be many more 
later motion events on the queue. 


Indicates whether the pointer is currently on the same screen as this win- 
dow. This is always True unless the pointer was actively grabbed 
before the automatic grab could take place. 


If the processing you have to do for every motion event is fast, you can probably handle all of 
them without requiring motion hints. However, if you have extensive processing to do for each 
one, you might be better off using the hints and calling XQueryPointer or using the history 
buffer if it exists. XQueryPointer is a round-trip request, so it can be slow. 


EnterNotify and LeaveNotify events are generated instead of MotionEvents if the 
pointer starts and stops in different windows. 


642 


Xlib Reference Manual - 


— xproperty PropertyNotify 


When Generated ; 
A PropertyNotify event indicates that a property of a window has changed or been 
deleted. This event can also be used to get the current server time (by appending zero-length 
data to a property). PropertyNotify events are generated by XChangeProperty, 
XDeleteProperty, XGetWindowProperty, or XRotateWindowProperties. 


Select With 
This event is selected with Propert yChangeMask. 


XEvent Structure Name 
typedef union XEvent { 


XPropertyEvent xproperty; 
} XEvent; 


Event Structure 
typedef struct { 


int type; 

unsigned long serial; /* # of last request processed by server */ 
Bool send event; /* True if this came from SendEvent request */ 
Display *display; /* Display the event was read from */ 


Window window; 

Atom atom; 

Time time; 

int state; /* property NewValue, property Deleted */ 


} XPropertyEvent; 


Event Structure Members 


window The window whose property was changed, not the window that selected the 
event. 

atom The property that was changed. 

state Either PropertyNewValue or PropertyDelete. Whether the property 
was changed to a new value or deleted. 

time The t ime member specifies the server time when the property was changed. 
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ReparentNotify xreparent— 


When Generated 
A ReparentNotify event reports when a client successfully reparents a window. 


Select With 
This event is selected with Subst ructureNotifyMask by specifying the window ID of the 
old or the new parent window or with StructureNotifyMask by specifying the window 
ID. 


XEvent Structure Name 
typedef union XEvent { 


XReparentEvent xreparent; 
} XEvent; 


Event Structure 
typedef struct { 


int type; 

unsigned long serial; /* # of last request processed by server */ 
Bool send _event; /* True if this came from SendEvent request */ 
Display *display; /* Display the event was read from */ 


Window event; 

Window window; 

Window parent; 

ra enexip Var 

Bool override redirect; 
} XReparentEvent; 


Event Structure Members 


window The window whose parent window was changed. 
parent The new parent of the window. 
x,Y The coordinates of the upper-left pixel of the window’s border rela- 


tive to the new parent window’s origin. 


override redirect The override_redirect attribute of the reparented window. If 
True, it indicates that the client wants this window to be immune 
to meddling by the window manager. Window managers normally 
should not have reparented this window to begin with. 
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—xresizerequest ResizeRequest 


When Generated ; 
A ResizeRequest event reports another client’s attempt to change the size of a window. 
The X server generates this event type when another client calls xConfigureWindow, 
XMoveResizeWindow, or XResizeWindow. If this event type is selected, the window is 
not resized. This gives the client that selects this event (usually the window manager) the 
opportunity to revise the new size of the window before executing the resize request or to deny 
the request itself. 


Select With 
To receive this event type, specify a window ID and pass ResizeRedirectMask as part of 
the event_mask argument to XSelect Input. Only one client can select this event on a 
particular window. When selected, this event is triggered instead of resizing the window. 


XEvent Structure Name 
typedef union  XEvent { 


XResizeRequestEvent xresizerequest; 
} XEvent; 


Event Structure 
typedef struct { 


int type; 

unsigned long serial; /* # of last request processed by server */ 
Bool send_event; /* True if this came from SendEvent request */ 
Display *display; /* Display the event was read from */ 


Window window; 
int width, height; 
} XResizeRequestEvent; 


Event Structure Members 
window The window whose size another client attempted to change. 


width, height The requested size of the window, not including its border. 
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SelectionClear ‘an Vastietntlagnas 


When Generated : 
A SelectionClear event reports to the current owner of a selection that a new owner is 


being defined. 


Select With 
This event is not selected. It is sent to the previous selection owner when another client calls 
XSetSelectionOwner for the same selection. 


XEvent Structure Name 
typedef union _XEvent { 


XSelectionClearEvent xselectionclear; 
} XEvent; 


Event Structure 
typedef struct { 


int type; 

unsigned long serial; /* # of last request processed by server */ 
Bool send_event; /* True if this came from SendEvent request */ 
Display *display; /* Display the event was read from */ 


Window window; 
Atom selection; 
Time time; 

} XSelectionClearEvent; 


Event Structure Members 
window The window that is receiving the event and losing the selection. 


selection The selection atom specifying the selection that is changing ownership. 
time The last-change time recorded for the selection. 
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—xselection SelectionNotify 


When Generated . 
A SelectionNotify event is sent only by clients, not by the server, by calling xSend- 
Event. The owner of a selection sends this event to a requestor (a client that calls 
XConvertSelection for a given property) when a selection has been converted and stored 
as a property or when a selection conversion could not be performed (indicated with property 
None). 


Select With 
There is no event mask for SelectionNotify events, and they are not selected with 
XSelectiInput. Instead xSendEvent directs the event to a specific window, which is 
given as a window ID: PointerWindow, which identifies the window the pointer is in, or 
InputFocus, which identifies the focus window. 


XEvent Structure Name 
typedef union XEvent { 


XSelectionEvent xselection; 
} XEvent; 


Event Structure 
typedef struct { 


int type; 

unsigned long serial; /* # of last request processed by server */ 
Bool send_event; /* True if this came from SendEvent request */ 
Display *display; /* Display the event was read from */ 


Window requestor; 
Atom selection; 
Atom target; 
Atom property; /* Atom or None */ 
Time time; 
} XSelectionEvent; 


Event Structure Members 
The members of this structure have the values specified in the XConvertSelection call 
that triggers the selection owner to send this event, except that the property member either 
will return the atom specifying a property on the requestor window with the data type specified 
in target or will return None, which indicates that the data could not be converted into the 


target type. 
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SelectionRequest xeelectionrequest— 


When Generated 
A Select ionRequest event is sent to the owner of a selection when another client requests 


the selection by calling xXConvertSelection. 


Select With 
There is no event mask for SelectionRequest events, and they are not selected with 


XSelectInput. 


XEvent Structure Name 
typedef union XEvent { 


XSelectionRequestEvent xselectionrequest; 
} XEvent; 


Event Structure 
typedef struct { 


int type; 

unsigned long serial; /* # of last request processed by server */ 
Bool send_event; /* True if this came from SendEvent request */ 
Display *display; /* Display the event was read from */ 


Window owner; 
Window requestor; 
Atom selection; 
Atom target; 
Atom property; 
Time time; 
} XSelectionRequestEvent; 


Event Structure Members 
The members of this structure have the values specified in the XConvertSelection call 
that triggers this event. 


The owner should convert the selection based on the specified target type, if possible. If a 
property is specified, the owner should store the result as that property on the requestor window 
and then send a SelectionNotify event to the requestor by calling xSendEvent. If the 
selection cannot be converted as requested, the owner should send a SelectionNotify 
event with property Set to the constant None. 
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— xvisibility VisibilityNotify 


When Generated 
A VisibilityNotify event reports any change in the visibility of the specified window. 
This event type is never generated on windows whose class is InputOnly. All of the win- 
dow’s subwindows are ignored when calculating the visibility of the window. 


Select With 
This event is selected with VisibilityChangeMask. 


XEvent Structure Name 
typedef union XEvent { 


XVisibilityEvent xvisibility; 
} XEvent; 


Event Structure 
typedef struct { 
int type; 
unsigned long serial; /* # of last request processed by server */ 


Bool send_ event; /* True if this came from SendEvent request */ 


Display *display; /* Display the event was read from */ 
Window window; 
int state; /* VisibilityObscured, 


* VisibilityPartiallyObscured, 
* VisibilityUnobscured*/ 


} XVisibilityEvent; 


Event Structure Members 


state A symbol indicating the final visibility status of the window: Visibility- 
Obscured, VisibilityPartiallyObscured, or Visibility- 
Unobscured. 
Notes 


Table E-S5 lists the transitions that generate VisibilityNotify events and the correspond- 
ing state member of the XVisibilityEvent structure. 
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VisibilityNotify 


650 


(continued) 


Table E-5. State Element of the XVisibilityEvent Structure 


Visibility Status Before Visibility Status After 







Partially obscured, Viewable and 
fully obscured, completely unobscured 
or not viewable 








Viewable and 
partially obscured 


Viewable and 
completely unobscured, 
or not viewable 










Viewable and 
partially obscured 


Viewable and 
completely unobscured, 
or viewable and 
partially obscured, 

or not viewable 







xvisibility 





VisibilityUnobscured 


VisibilityPartially- 
Obscured 


VisibilityPartially- 
Obscured 
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Structure Reference 


This appendix summarizes the contents of the include files for Xlib, and presents each struc- 
ture in alphabetical order. 


Description of Header Files 


All include files are normally located in /usr/include/X11. All Xlib programs require 
<X11/Xlib.h>, which includes <X11/X.h>. <X11/Xlib.h> contains most of the structure dec- 
larations, while <XJJ/X.h> contains most of the defined constants. Virtually all programs 
will also require <XJ1/Xutil.h>, which include structure types and declarations applicable to 
window manager hints, colors, visuals, regions, standard geometry strings, and images. 


Here is a summary of the contents of the include files: 


<X11/Xlib.h> 
<X11/X.h> 
<X11/Xutil.h> 


<X11/Xatom.h> 
<X11/cursorfont.h> 


<X11/keysym.h> 


<X11/Xresource.h> 


structure declarations for core Xlib functions. 
constant definitions for Xlib functions. 


additional structure types and constant definitions for miscellaneous 
Xlib functions. 


the predefined atoms for properties, types, and font characteristics. 


the constants used to select a cursor shape from the standard cursor 
font. 


predefined key symbols corresponding to keycodes. It includes 
<X11/keysymdef.h>. 


resource manager structure definitions and function declarations. 


Appendix F: Structure Reference . 651 


fae) 
mac) 
oO 
Lr 
o 
i 
—] 
lo) 
Lae} 


CORP LP KS 





F.2 Resource Types 


The following types are defined in <XJJ/X.h>: 


unsigned long XID 

XID Colormap 

XID Cursor 

XID Drawable 

XID Font 

XID GContext 

XID KeySym 

XID Pixmap 

XID Window 

unsigned long Atom 
unsigned char KeyCode 
unsigned long Mask 
unsigned long Time | 
unsigned long VisualID 


F.3 Structure Definitions 


F.3.1 


This section lists all public Xlib structure definitions in X1ib.h and Xutil.h, in alphabet- 
ical order, except the event structures, which are listed on the reference page for each event 
in Appendix E, Event Reference. 


Before each structure is a description of what the structure is used for and a list of the Xlib 
routines that use the structure. 


XArc 


XArc specifies the bounding box for an arc and two angles indicating the extent of the arc 
within the box. A list of these structures is used in XDrawArcs and XFillArcs. 


typedef struct { 
short: x, ys 
unsigned short width, height; 
short anglel, angle2; 

} XArc; 
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3.2 XChar2b 


XChar2b specifies a character in a two-byte font. A list of structures of this type is an argu- 
ment to XDrawImageStringl16, XDrawStringl6, XDrawText16, XQueryText— 
Extents16, XTextExtents16, and XTextWidth16. The only two-byte font cur- 


rently available is Kanji (Japanese). 


typedef struct { /* normal 16 bit characters are two bytes */ 


unsigned char bytel; 
unsigned char byte2; 
} XChar2b; 
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3.3 XCharStruct 


XCharStruct describes the metrics of a single character in a font or the overall character- 
istics of a font. This structure is the type of several of members of XFont Struct and is 
used to return the overall characteristics of a string in XQueryTextExtents* and 


XTextExtents*. 

typedef struct { 
short lbearing; /* origin to left edge of raster */ 
short rbearing; /* origin to right edge of raster */ 
short width; /* advance to next char’s origin */ 
short ascent; /* baseline to top edge of raster */ 
short descent; /* baseline to bottom edge of raster */ 
unsigned short attributes; /* per char flags (not predefined) */ 


} XCharStruct; 


3.4 XClassHint 


XClassHint is used to set or get the XA_WM CLASS HINT property for an application’s 
top-level window, as arguments to XSetClassHint or XGetClassHint. 


typedef struct { 
char *res_ name; 
char) *resiiclass; 
} XClassHint; 


3.5 XColor 


XColor describes a single colorcell. This structure is used to specify and return the pixel 
value and RGB values for a colorcell. The flags indicate which of the RGB values should be 
changed when used in XStoreColors, XAllocNamedColor, or XAllocColor. 
Also used in XCreateGlyphCursor, XCreatePixmapCursor, XLookupColor, 
XParseColor, XQueryColor, XQueryColors, and XRecolorCursor. 
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F.3.7 


F.3.8 


typedef struct { 
unsigned long pixel; 
unsigned short red, green, blue; 
char flags; /* DoRed, DoGreen, DoBlue */ 
char pad; 
} XColor; 


XComposeStatus 


XComposeStatus describes the current state of a multikey character sequence. Used in 
calling XLookupSt ring. This processing is not implemented in the MIT sample servers. 
typedef struct _XComposeStatus { 

char *compose ptr; /* state table pointer */ 


int chars_matched; /* match state */ 
} XComposeStatus; 


XExtCodes 


XExtCodes is a structure used by the extension mechanism. This structure is returned by 
XInitExtension which is not a standard Xlib routine but should be called within the 
extension code. Its contents are not normally accessible to the application. 


typedef struct { /* public to extension, cannot be changed */ 
int extension; /* extension number */ 
int major opcode; /* major opcode assigned by server */ 
int first_event; /* first event number for the extension */ 
inc first cerror, /* first error number for the extension */ 


} XExtCodes; 


XExtData 


XExtData provides a way for extensions to attach private data to the existing structure 
types GC, Visual, Screen, Display, and XFontStruct. This structure is not used 
in normal Xlib programming. 


typedef struct XExtData { 


int number; /* number returned by XRegisterExtension */ 
struct XExtData *next; /* next item on list of data for structure */ 
int (*free private) (); /* called to free private storage */ 
char *private data; /* data private to this extension */ 

} XExtData; 
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F.3.10 


F.3.11 


XFontProp 


XFontProp is used in XFont Struct. This structure allows the application to find out 
the names of additional font properties. beyond the predefined set, so that they too can be 
accessed with XGetFontProperty. This structure is not used as an argument or return 
value for any core Xlib function. 
typedef struct { 

Atom name; 


unsigned long card32; 
} XFontProp; 
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XFontStruct 


XFontStruct specifies metric information for an entire font. This structure is filled with 
the XLoadQueryFont and XQueryFont routines. List Font sWithInfo also fills it 
but with metric information for the entire font only, not for each character. A pointer to this 
structure is used in the routines XFreeFont, XFreeFontInfo, XGetFontProp, 
XTextExtents*, and XTextWidth*. 


typedef struct { 


XExtData *ext_data; /* hook for extension to hang data */ 
Font fid; /* font ID for this font */ 
unsigned direction; /* direction the font is painted */ 


unsigned min_char or byte2; /* first character */ 
unsigned max_char_or byte2; /* last character */ 


unsigned min_bytel; /* first row that exists */ 

unsigned max_bytel; /* last row that exists */ 

Bool all chars exist; /* flag if all characters have nonzero size*/ 
unsigned default char; /* char to print for undefined character */ 

int n_properties; /* how many properties there are */ 

XFontProp *properties; /* pointer to array of additional properties*/ 
XCharStruct min_bounds; /* minimum bounds over all existing char*/ 
XCharStruct max bounds; /* maximum bounds over all existing char*/ 
XCharStruct *per char; /* first _char to last char information */ 

int ascent; /* logical extent above baseline for spacing */ 
int descent; /* logical descent below baseline for spacing */ 


} X¥FontStruct; 


XGCValues 


XGCValues is used to set or change members of the GC by the routines XCreateGC and 
XChangeGC. 


typedef struct { 


int function; /* logical operation */ 
unsigned long plane mask; /* plane mask */ 
unsigned long foreground; /* foreground pixel */ 


Appendix F: Structure Reference 655 


F.3.12 


F.3.13 


unsigned long background; /* background pixel */ 


int line width; /* line width */ 

int line style; /* LineSolid, LineOnOffDash, LineDoubleDash */ 
int cap style; /* CapNotLast, CapButt, CapRound, CapProjecting */ 
int join style; /* JoinMiter, JoinRound, JoinBevel */ 

int fill. style; /* FillSolid, FillTiled, FillStippled */ 

int £31 erole; /* EvenOddRule, WindingRule */ 

int arc mode; /* ArcPieSlice, ArcChord */ 

Pixmap tile; /* tile pixmap for tiling operations */ 

Pixmap stipple; /* stipple 1 plane pixmap for stippling */ 

int “ts °x origin; /* offset for tile or stipple operations */ 
int) tsy origin; 

Font font; /* default text font for text operations */ 
int subwindow_mode; /* ClipByChildren, IncludeInferiors */ 

Bool graphics exposures; /* Boolean, should exposures be generated */ 
int clip x origin; /* origin for clipping */ 

int clip y origin; 

Pixmap clip mask; /* bitmap clipping; other calls for rects */ 
int dash offset; /* patterned/dashed line information */ 


char dashes; 
} XGCValues; 


XHostAddress 


XHostAddress specifies the address of a host machine that is to be added or removed from 
the host access list for a server. Used in XAddHost, XAddHosts, XListHosts, 
XRemoveHost, and XRemoveHosts. 


typedef struct { 


int family; /* for example FAMILY INTERNET */ 
int length; /* length of address, in bytes */ 
char *address; /* pointer to where to find the bytes */ 


} XHostAddress; 


XiconSize 


XIconSize is Used to set or read the XA_WM_ICON SIZE property. This is normally set by 
the window manager with XSet IconSizes and read by each application with xGet — 
IconSizes. 


typedef struct { 
int min_width, min height; 
int max_width, max height; 
int width inc, height inc; 
} XIconSize; 
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3.14 Ximage 


XImage describes an area of the screen; is used in XCreateImage, XDest royImage, 
XGetPixel, XPutPixel, XSubImage, XAddPixel, XGetImage, XGetSub- 





Image, and XPut Image. ~ 
typedef struct XImage { e 
int width, height; /* size of image */ ) 
int xoffset; /* number of pixels offset in X direction */ B 
int format; /* XYBitmap, XYPixmap, ZPixmap */ i 
char *data; /* pointer to image data */ 
int byte order; /* data byte order, LSBFirst, MSBFirst */ 
int bitmap unit; /* quant. of scan line 8, 16, 32 */ 
int bitmap bit order; 7* LSBFirst, MSBFirst */ 
int bitmap pad; /* 8, 16, 32 either XY or ZPixmap */ 
int depth; /* depth of image */ ; 
int bytes per line; /* accelerator to next line */ 
int, bits per pixel; /* bits per pixel (ZPixmap) */ 
unsigned long red _ mask; /* bits in z arrangement */ 


unsigned long green_mask; 
unsigned long blue mask; 


char *obdata; /* hook for the object routines to hang on */ 
struct funcs { /* image manipulation routines */ 
struct XImage *(*create image) (); 
int (*destroy image) (); 
unsigned long (*get_ pixel) (); 
int (*put_pixel) (); 
struct XImage *(*sub image) (); 
int (*add pixel) (); 
} fF 
} XImage; 


3.15 XKeyboardControl 


XKeyboardControl is used to set user preferences with XChangeKeyboard- 
Control. 


typedef struct { 

int key click percent; 

int bell percent; 

int bell pitch; 

int bell duration; 

int led; 

int led mode; 

int key; 

int auto repeat _ mode; /* AutoRepeatModeOn, AutoRepeatModeOff, 

* AutoRepeatModeDefault */ 

} XKeyboardControl; 
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F.3.19 


XKeyboardState 


XKeyboardState is used to return the current settings of user preferences with XGet - 
KeyboardControl. 


typedef struct { 
int key click_percent; 
int bell percent; 
unsigned int bell pitch, bell duration; 
unsigned long led_mask; 
int global auto repeat; 
char auto _repeats([32]; 
} XKeyboardState; 


XModifierKeymap 


XModifierKeymap specifies which physical keys are mapped to modifier functions. This 
structure is returned by XGetModifierMapping and is an argument to XDelete- 
ModifiermapEntry, XFreeModifiermap, XInsertModifiermapEntry, 
XNewModifiermap, and XSetModifierMapping. 


typedef struct { 
int max_keypermod; /* server's max # of keys per modifier */ 
KeyCode *modifiermap; /* an 8 by max keypermod array of modifiers */ 
} XModifierKeymap; 7 


XPixmapFormatValues 


XPixmapFormatValues describes one pixmap format that is supported on the server. A 
list of these structures is returned by XListPixmapFormats. 


typedef struct { 
int depth; 
int bits per pixel; 
int scanline pad; 

} XPixmapFormatValues; 


XPoint 


xPoint specifies the coordinates of a point. Used in XDrawPoints, XDrawLines, 
XFil1Polygon, and XPolygonRegion. 


typedef struct { 
shore: x; y:7 
} XPoint; 
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XRectangle 


XRectangle specifies a rectangle. Used in XClipBox, XDrawRectangles, XFill- 
Rectangles, XSetClipRectangles, and XUnionRectWithRegion. 


typedef struct { 

short x, y? 

unsigned short width, height; 
} XRectangle; 


XSegment 


XSegment specifies two points. Used in XDrawSegments. 


typedef struct { 
short. xl, vl, X2,<Vvar 
} XSegment ; 


XSetWindowAittributes 


XSetWindowAttributes contains all the attributes that can be set without window man- 
ager intervention. Used in XChangeWindowAttributes and XCreateWindow. 


typedef struct { 


Pixmap background pixmap; /* background or None or ParentRelative */ 
unsigned long background pixel;/* background pixel */ 

Pixmap border pixmap; /* border of the window */ 

unsigned long border pixel; /* border pixel value */ 

int bit gravity; /* one of bit gravity values */ 

int win_gravity; /* one of the window gravity values */ 

int backing store; /* NotUseful, WhenMapped, Always, */ 


unsigned long backing planes; /* planes to be preserved if possible */ 
unsigned long backing pixel; /* value to use in restoring planes */ 
Bool save _ under; /* should bits under be saved? (popups) */ 
long event_mask; /* set of events that should be saved */ 
long do_not_propagate_ mask; /* set of events that should not */ 

* propagate */ 


Bool override redirect; /* Boolean value for override-redirect */ 
Colormap colormap; /* colormap to be associated with window */ 
Cursor cursor; /* cursor to be displayed (or None) */ 


} XSetWindowAttributes; 
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XSizeHints 


XSizeHints describes a range of preferred sizes and aspect ratios. Used to set the 
XA_WM NORMAL HINTS and XA_WM ZOOM HINTS properties for the window manager with 
XSetStandardProperties, XSetNormalHints, XSetSizeHints, or XSet- 
ZoomHints in R3, and XSetWMProperties, XSetWMNormalHints, and XSet- 
WMSizeHints in R4. Also used in reading these properties with XGetNormalHints, 
XGetSizeHints, or XGetZoomHints in R3, and XGetWMNormalHints and 


XGetWMSizeHints. 


typedef struct { 
long flags; 
INGER V7 
int width, height; 
int min_width, min_height; 
int max width, max_height; 
int width_inc, height inc; 
struct { 
int -x. 
Lntisys 
} min_aspect, max_aspect; 
int base width, base height; 
int win gravity; 
} XSizeHints; 


XStandardColormap 


/* 


/* 


/* 
/* 


/* 
/* 


marks defined fields in structure */ 
obsolete in R4 */ 
obsolete in R4 */ 


numerator */ 
denominator */ 


Added in R4 */ 
Added in R4 */ 


XStandardColormap describes a standard colormap, giving its ID and its color character- 
istics. This is the format of the standard colormap properties set on the root window, which 
can be changed with XSet RGBColormaps (XSet StandardProperties in R3) and 
read with XGet RGBColormaps (XGet StandardProperties in R3). 


typedef struct { 
Colormap colormap; 
unsigned long red _ max; 
unsigned long red mult; 
unsigned long green_max; 
unsigned long green mult; 
unsigned long blue max; 
unsigned long blue mult; 
unsigned long base pixel; 
VisualID visualid; 
XID killid; 

} XStandardColormap; 
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13.20 


3.26 


3.27 


XTextitem 


XText Item describes a string, the font to print it in, and the horizontal offset from the pre- 
vious string drawn or from the location specified by the drawing command. Used in 


XDrawText. 


typedef struct { 
char *chars; 
int nchars; 
int delta; 
Font font; 

} XTextItem; 


XTextitem16 


/* 
/* 
/* 
/* 


pointer to string */ 

number of characters */ 

delta between strings */ 

font to print it in, None don’t change */ 


XTextItem16 describes a string in a two-byte font, the font to print it in, and the horizontal 
offset from the previous string drawn or from the location specified by the drawing com- 


mand. Used in XDrawText16. 


typedef struct { 
XChar2b *chars; 
int nchars; 
int delta; 
Font font; 

} XTextIteml16; 


XTextProperty 


/* 
/* 
/* 
/* 


two-byte characters */ 

number of characters */ 

delta between strings */ 

font to print it in, None don’t change */ 


XTextProperty holds the information necessary to write or read a TEXT property, which 
contains a list of strings. This structure is used by many of the R4 routines that write and 
read window manager hints that are in string format. The purpose of this structure is to allow 
these properties to be processed in non-european languages where more than 8 bits might be 
needed. These structures are also used in XGet Text Property, XSetTextProperty, 
XStringListToTextProperty, and XTextPropertyToStringList. 


typedef struct { 
unsigned char *value; 
Atom encoding; 
int format; 
unsigned long nitems; 
} XTextProperty; 
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/* 
/* 
/* 
/* 


same as Property routines */ 

prop type */ 

prop data, formats, 8; 6, orl) </ 
number of data items in value */ 
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F.3.28 


F.3.29 


F.3.30 


XTimeCoord 


XTimeCoord specifies a time and position pair, for use in tracking the pointer with XGet— 
MotionEvents. This routine is not supported on all systems. 


typedef struct { 
Time time; 
Short) X, «yy? 

} XTimeCoord; 


XVisuallnfo 


XVisualInfo contains all the information about a particular visual. It is used in XGet— 
VisualInfo and XMatchVisuallInfo to specify the desired visual type. The 
visual member of XVisualInfo is used for the visual argument of XCreate- 
Colormap or XCreateWindow. 


typedef struct { 
Visual *visual; 
VisualID visualid; 
int screen; 
unsigned int depth; 
int class; 
unsigned long red_mask; 
unsigned long green_mask; 
unsigned long blue_mask; 
int colormap_ size; 
int bits per rgb; 
} XVisualinfo; 


XWindowAittributes 


XWindowAttributes describes the complete set of window attributes, including those 
that cannot be set without window manager interaction. This structure is returned by XGet — 
WindowAttributes. It is not used by XChangeWindowAttributes or 
XCreateWindow. 


typedef struct { 


inte x; 2+ /* location of window */ 

int width, height; /* width and height of window */ 

int border width; /* border width of window */ 

int depth; /* depth of window */ 

Visual *visual; /* the associated visual structure */ 
Window root; /* root of screen containing window */ 
int class; /* InputOutput, InputOnly*/ 

int bit _gravity; /* one of bit gravity values */ 

int win_gravity; /* one of the window gravity values */ 
int backing store; /* NotUseful, WhenMapped, Always */ 
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unsigned long backing planes; /* planes to be preserved if possible */ 
unsigned long backing_pixel; /* value to be used when restoring planes */ 


Bool save_under; /* Boolean, should bits under be saved */ 

Colormap colormap; /* colormap to be associated with window */ 

Bool map_installed; /* Boolean, is colormap currently installed*/ 

int map_state; /* IsUnmdpped, IsUnviewable, IsViewable */ mbes 

long all_event_masks; /* events all people have interest in*/ A es 

long your_event_mask; /* my event mask */ ec 

long do_not_ propagate mask; /* set of events that should not propagate */ = oo 

Bool override redirect; /* Boolean value for override-redirect */ sd ed 
oe & 


Screen *screen; 
} XWindowAttributes; 





‘3.31 XWindowChanges 


XWindowChanges describes a configuration for a window. Used in XConfigure- 
Window, which can change the screen layout and therefore can be intercepted by the win- 
dow manager. This sets some of the remaining members of XWindowAttributes that 
cannot be set with XChangeWindowAttributes or XCreateWindow. 


typedef struct { 
int xX; Vie 
int width, height; 
int border width; 
Window sibling; 
int stack_mode; 

} XWindowChanges; 


3.32 XWMHints 


XWMHints describes various application preferences for communication to the window 
manager via the XA_WM_HINTS property. Used in XSetWMHints and XGetWMHints. 


typedef struct { 


long flags; /* marks defined fields in structure */ 
Bool input; /* does application need window manager for 
* keyboard input */ 
int initial state; /* see below */ 
Pixmap icon_pixmap; /* pixmap to be used as icon */ 
Window icon window; /* window to be used as icon */ 
int icon_x, icon _y; /* initial position of icon */ 
Pixmap icon_mask; /* icon mask bitmap */ 
XID window _group; /* ID of related window group */ 
/* this structure may be extended in the future */ 
} XWMHints; 
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Symbol Reference 


This appendix presents an alphabetical listing of the symbols used in Xlib. The routines in 
parentheses following the descriptions indicate the routines associated with those symbols. 


A 
Above 


AllHints 


AllocAl1l 


AllocNone 


AllowExposures 


AllTemporary 


AllValues 
AlreadyGrabbed 


Always 


AnyButton 


AnyKey 


AnyModifier 


Specifies that the indicated window is placed above the indi- 
cated sibling window. (XConfigureWindow) 


XA_WM HINTS property, stores optional information for the 
window manager. If AllHints is set, all members of 
XA_WM HINTS are set. (XGetWMHints, XSetWMHints) 


Creates a colormap and allocates all of its entries. Available 
for the DirectColor, GrayScale, and PseudoColor visual 
classes only. (XCreateColormap) 


Creates a colormap and allocates none of its entries. 
(XCreateColormap) 
Specifies that exposures are generated when the screen is 


restored after blanking. (XGetScreenSaver, XSetScreen- 
Saver) 


Specifies that the resources of all clients that have terminated 
in RetainTemporary (see XSetCloseDownMode) should be 
killed. (XKill1Client) 


Mask used by XParseGeomet ry; returns those set by user. 


Specifies that the pointer or keyboard is actively grabbed by 
another client. (XGrabKeyboard, XGrabPointer) 


Advises the server to maintain contents even when the window 
is unmapped. (XChangeWindowAttributes, XCreate- 
Window) 


Specifies that any button is to be grabbed (XGrabButton) or 
ungrabbed (XUngrabButton) or that any button will trigger a 
ButtonPress Or ButtonRelease event. 


Specifies that any key is to be grabbed or ungrabbed. (xGrab- 
Key, XUngrabKey) 


Specifies a modifier keymask for XGrabButton, XGrabKey, 
and XUngrabKey, and for the results of XQueryPointer. 
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AnyPropertyType 


ArcChord 


ArcPieSlice 


AsyncBoth 


AsyncKeyboard 


AsyncPointer 


AutoRepeatModeDefault 


AutoRepeatModeOff 


AutoRepeatModeOn 


B 


BadAccess 


BadAlloc 
BadAtom 
BadColor 


BadCursor 
BadDrawable 


BadFont 
BadGC 
BadIDChoice 


BadImplementation 
BadLength 
BadMatch 
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Specifies that the property from a specified window should be 
returned regardless of its type. (KGetWindowProperty) 
Value of the arc_mode member of the GC: specifies that the 
area between the arc and a line segment joining the endpoints 
of the arc is filled. (xSetArcMode) 

Value of the arc_mode member of the GC: specifies that the 
area filled is delineated by the arc and two line segments con- 
necting the ends of the arc to the center point of the rectangle 
defining the arc. (XSetArcMode) 

Specifies that pointer and keyboard event processing resume 
normally if both the pointer and the keyboard are frozen by the 
client when XAllowEvents is called with AsyncBoth. 
(XAllowEvents) 

Specifies that keyboard event processing resumes normally if 
the keyboard is frozen by the client when XAllowEvents is 
called with AsyncPointer. (XAllowEvents) 

Specifies that pointer event processing resumes normally if the 
pointer is frozen by the client when XAllowEvents is called 
with AsyncPointer. (XAllowEvents) 


Value of auto repeat _mode: specifies that the key or key- 
board is set to the default setting for the server. (XChange- 
KeyboardControl, XGetKeyboardControl) 


Value of auto repeat mode: specifies that no keys will 
repeat. (XChangeKeyboardControl, XGetKeyboard- 
Control) 


Value of auto repeat mode: specifies that keys that are set 
tO auto_repeat will do so. (KChangeKeyboardControl, 
XGetKeyboardControl) 


Used by non-fatal error handlers only, meaning depends on 
context. 


Used by non-fatal error handlers only, insufficient resources. 
Used by non-fatal error handlers only, parameter not an Atom. 
Used by non-fatal error handlers only, no such colormap. 


Used by non-fatal error handlers only, parameter not a Cur- 
sor. 


Used by non-fatal error handlers only, parameter not a Pixmap 
or Window. 


Used by non-fatal error handlers only, parameter not a Font. 
Used by non-fatal error handlers only, parameter not a GC. 


Used by non-fatal error handlers only, choice not in range or 
already used. 


Used by non-fatal error handlers only, server is defective. 
Used by non-fatal error handlers only, request length incorrect. 
Used by non-fatal error handlers only, parameter mismatch. 
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BadName 
BadPixmap 


BadRequest 
BadValue 


BadWindow 

Below 
BitmapFileInvalid 
BitmapNoMemory 
BitmapOpenFailed 
BitmapSuccess 


BottomIif 


Buttonl 
Button1lMask 
Button1lMotionMask 
Button2 
Button2Mask 
Button2MotionMask 
Button3 
Button3Mask 
Button3Mot ionMask 
Button4 


Button4Mask 
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Used by non-fatal error handlers only, font or color name does 
not exist. 


Used by non-fatal error handlers only, parameter not a Pix- 
map., 

Used by non-fatal error handlers only, bad request code. 

Used by non-fatal error handlers only, integer parameter out of 
range. 

Used by non-fatal error handlers only, parameter not a Win- 
dow. 

Specifies that the indicated window is placed below the indi- 
cated sibling window. (xConfigureWindow) 

Specifies that a file does not contain valid bitmap data. 
(XReadBitmapFile, XWriteBitmapFile) 

Specifies that insufficient working storage is allocated. 
(XReadBitmapFile, XWriteBitmapFile) 

Specifies that a file cannot be opened. (XReadBitmapFile, 
XWriteBitmapFile) 

Specifies that a file is readable and valid. (XReadBitmap- 
File, XWriteBitmapFile) 


Specifies that the indicated window is placed at the bottom of 
the stack if it is obscured by the indicated sibling window. 
(XConfigureWindow) 


Specifies that button] is to be grabbed (xGrabButton) or 
ungrabbed (XUngrabButton). 


Returns the current state of buttonl. (XQueryPointer) 


Specifies that any button] MotionNotify events are to be 
selected for this window. A MotionNotify event reports 
pointer movement. (XSelect Input) 


Specifies that button2 is to be grabbed (XGrabButton) or 
ungrabbed (XUngrabButton). 


Returns the current state of button2. (XQueryPointer) 


Specifies that any button2 MotionNotify events are to be 
selected for this window. A MotionNotify event reports 
pointer movement. (XSelect Input) 


Specifies that button3 is to be grabbed (XGrabButton) or 
ungrabbed (xUngrabButton). 


Returns the current state of button3. (XQueryPointer) 


Specifies that any button3 MotionNotify events are to be 
selected for this window. A MotionNotify event reports 
pointer movement. (xSelect Input) 


Specifies that button4 is to be grabbed (XGrabButton) or 
ungrabbed (XUngrebButton). 


Returns the current state of button4. (XQueryPointer) 
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Button4MotionMask 


Button5 


Button5Mask 
Button5MotionMask 


ButtonMot ionMask 


ButtonPress 


ButtonPressMask 


ButtonRelease 


ButtonReleaseMask 


C 


CapButt 


CapNotLast 


CapProjecting 


CapRound 


CenterGravity 


CirculateNotify 
CirculateRequest 
ClientIconState 


ClientMessage 
ClipByChildren 
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Specifies that any button4 MotionNotify events are to be 
selected for this window. A MotionNotify event reports 
pointer movement. (xSelect Input) 


Specifies that buttonS is to be grabbed (XGrabButton) or 
ungrabbed (XUngrabButton). 


Returns the current state of buttonS. (XQueryPointer) 


Specifies that any buttonS Mot ionNotify events are to be 
selected for this window. A MotionNotify event reports 
pointer movement. (xSelect Input) 


Specifies that any button MotionNotify events are to be 
selected for this window. A MotionNotify event reports 
pointer movement. (XSelect Input) 


Event type. 


Specifies that any ButtonPress events are to be selected for 
this window. A ButtonPress event reports that a pointing 
device button has been pressed. (XSelect Input) 


Event type. 


Specifies that any ButtonRelease events are to be selected 
for this window. A ButtonRelease event reports that a 
pointing device button has been released. (xSelect Input) 


Value of the cap_style member of a GC: specifies that lines 
will be square at the endpoint with no projection beyond. 
(XSetLineAttributes) 


Value of the cap style member of a GC: equivalent to 
CapButt except that, for a line width of 0 or 1, the final 
endpoint is not drawn. (XSetLineAttributes) 


Value of the cap_style member of aGC: specifies that lines 
will be square at the end but with the path continuing beyond 
the endpoint for a distance equal to half the line width. 
(XSetLineAttributes) 


Value of the cap_style member of a GC: specifies that lines 
will be terminated by a circular arc. (XSetLineAttributes) 


When a window is resized, specifies the new location of the 
contents or the children of the window. (xChangeWindow- 
Attributes, XCreateWindow) 


Event type. 
Event type. 


Indicates that the client wants its icon_window to be visible. 
If an icon_window is not available, it wants its top-level win- 
dow visible. (Value for initial state member of 
XWMHints.) - 


Event type. 


Value of the subwindow_mode member of the GC: specifies 


that graphics requests will not draw through viewable children. 
(XSet SubwindowMode) 
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ColormapChangeMask 


ColormapInstalled 


ColormapNotify 


ColormapUninstalled 


Complex 


ConfigureNotify 
ConfigureRequest 


ControlMapIndex 


ControlMask 


Convex 


CoordModeOrigin 


CoordModePrevious 


CopyFromParent 


CreateNotify 
CurrentTime 


CursorShape 


CWBackingPixel 


CWBackingPlanes 


CWBackingStore 


CWBackPixel 


CWBackPixmap 


CWBitGravity 
CWBorderPixel 
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Specifies that ColormapNot ify events are to be selected for 
the window. A ColormapNotify event reports colormap 
changes. (XSelect Input) 


In a ColormapNotify event, specifies that the colormap is 
installed. ; 
Event type. 


In a ColormapNotify event, specifies that the colormap is 
uninstalled. 


Specifies that paths may self-intersect in polygon shapes. 
(XFillPolygon) 

Event type. 

Event type. 


Identifies one of eight modifiers to which keycodes can be 
mapped. (XDeleteModifiermapEntry, XGetModifier- 
Mapping, XInsertModifiermapEntry, XLookupKeysym, 
XSetModifierMapping) 

Specifies a modifier keymask for XGrabButton, XGrabKey, 
XUngrabButton, and XUngrabKey, and for the results of 
XQueryPointer. 

Specifies that a polygon’s path is wholly convex. (XFill- 
Polygon) 

Specifies that all coordinates are relative to the origin of the 
drawable. (XDrawLines, XDrawPoints, XFillPolygon) 
Specifies that all coordinates are relative to the previous point 
(the first point is relative to the origin). (XDrawLines, 
XDrawPoints, XFillPolygon) 

Specifies that a window’s border pixmap, visual ID, or class 
should be copied from the window’s parent. (XChange- 
WindowAttributes, XCreateWindow) 

Event type. 

Specifies time in most time arguments. 


Specifies the “best” supported cursor size available on the dis- 
play hardware. (XQueryBestSize) 


Mask to set the backing pixel window attribute. 
(XChangeWindowAttributes, XCreateWindow) 


Mask to set the backing planes window 
(XChangeWindowAttributes, XCreateWindow) 


Mask to set the backing store window 
(XChangeWindowAttributes, XCreateWindow) 


Mask to set the background_pixel window attribute. 
(XChangeWindowAttributes, XCreateWindow) 


Mask to set the kackground pixmap window attribute. 
(XChangeWindowAttributes, XCreateWindow) 


Mask to set the bit gravity window attribute. 
Mask to set the border pixel window attribute. 


attribute. 


attribute. 
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CWBorderPixmap 
CWBorderWidth 


CWColormap 
CWCursor 
CWDontPropagate 
CWEventMask 
CWHeight 
CWOverrideRedirect 
CWSaveUnder 
CWSibling 
CWStackMode 
CWWidth 
CWWinGravity 
CWX 


CWY 


DEF 


DefaultBlanking 


DefaultExposures 


DestroyAll 


DestroyNotify 


DirectColor 


DisableAccess 


Mask to set the border _pixmap window attribute. 
Mask to set a new width for the window’s border. 
(XConfigureWindow) 


Mask to set the colormap window attribute. (xChange- 
WindowAttributes, XCreateWindow) 


Mask to set the cursor window attribute. (XChange- 
WindowAttributes, XCreateWindow) 


Mask to set the do not propagate _mask window attribute. 
(XChangeWindowAttributes, XCreateWindow) 


Mask to set the event_mask window attribute. (xChange- 
WindowAttributes, XCreateWindow) 


Mask to set a new height for the window. (xConfigure- 
Window) 


Mask to set the override redirect window attribute. 
(XChangeWindowAttributes, XCreateWindow) 


Mask to set the save under window attribute. (XChange- 
WindowAttributes, XCreateWindow) 


Mask to specify a sibling of the window, used in stacking 
operations. (XConfigureWindow) 


Mask to set a new stack mode for the window. (XConfigure- 
Window) 


Mask to set a new width for the window. (XConfigure- 
Window) 


Mask to set the win gravity window attribute. (XChange- 
WindowAttributes, XCreateWindow) 


Mask to set a new X value for the window’s position. 
(xConfigureWindow) 


Mask to set a new Y value for the window’s position. 
(XConfigureWindow) 


Specifies default screen saver screen blanking. (xGet- 
ScreenSaver, XSet ScreenSaver) 


Specifies that the default <??what default??> will govern 
whether or not exposures are generated when the screen is 
restored after blanking. (xGetScreenSaver, XSetScreen- 
Saver) 


Specifies that all resources associated with a client/server con- 
nection will be freed when the client process dies. (xSet- 
CloseDownMode) 


Event type. 


Visual class, read/write. (XGetVisualInfo, XMatch- 
VisualInfo) 


Specifies that clients from any host have access unchallenged 
(access control is disabled). (XSetAccessControl) 


DisableScreenInterval Internal to Xlib. 
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DisableScreenSaver 
DoBlue 


DoGreen 


DontAllowExposures 


DontCareState 


DontPreferBlanking 


DoRed 


EastGravity 


EnableAccess 


EnterNotify 
EnterWindowMask 


EvenOddRule 


Expose 


ExposureMask 


FamilyChaos 
FamilyDECnet 
FamilyInternet 


FillOpaqueStippled 


Internal to Xlib. 


Sets or changes the read/write colormap cell that corresponds 
to the specified pixel value to the hardware color that most 
closely: matches the specified blue value. (xStoreColor, 
XStoreColors, XStoreNamedColor) 


Sets or changes the read/write colormap cell that corresponds 
to the specified pixel value to the hardware color that most 
closely matches the specified green value. (xStoreColor, 
XStoreColors, XStoreNamedColor) 


Specifies that exposures are not generated when the screen is 
restored after blanking. (xGetScreenSaver, XSetScreen- 
Saver) 


Indicates that the client does not know or care what the initial 
state of the client is when the top-level window is mapped. 
Obsolete in R4. (Value for initial state member of 
XWMHints.) 


Specifies no screen saver screen blanking. (xGetScreen- 
Saver, XSetScreenSaver) 


Sets or changes the read/write colormap cell that corresponds 
to the specified pixel value to the hardware color that most 
closely matches the specified red value. (XStoreColor, 
XStoreColors, XStoreNamedColor) 


When a window is resized, specifies the new location of the 
contents or the children of the window. (XChangeWindow- 
Attributes, XCreateWindow) 


Specifies that the host access list should be checked before 
allowing access to clients running on remote hosts (access con- 
trol is enabled). (XSetAccessControl) 


Event type. 


Specifies that any EnterNotify events are to be selected for 
this window. An EnterNotify event reports pointer window 
entry. (XSelect Input) 


Value of the £i11_rule member of a GC: specifies that areas 
overlapping an odd number of times should not be part of the 
region. (XPolygonRegion, XSetFillRule) 


Event type. 


Specifies that any exposure event except GraphicsExpose or 
NoExpose is to be selected for the window. An Expose event 
reports when a window or a previously invisible part of a win- 
dow becomes visible. (XSelect Input) 


Specifies an address in the ChaosNet network. (xAddHost) 
Specifies an address in the DECnet network. (XAddHost) 
Specifies an address in the Internet network. (xAddHost) 


Value of the fi11 style member of a GC: specifies that 
graphics should be drawn using stipple, using the fore- 
ground pixel value for set bits in stipple and the background 
pixel value for unset bits in pixel. (XSetFillStyle) 
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FillSolid 


FillStippled 


FillTiled 


FirstExtensionError 


FocusChangeMask 


FocusIn 
FocusOut 
FontChange 
FontLeftToRight 


FontRightToLeft 


ForgetGravity 


G 


GCArcMode 
GCBackground 
GCCapStyle 
GCClipMask 
GCClipXOrigin 
GCClipYOrigin 


GCDashList 
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Value of the £111 style member of a GC: specifies that 
graphics should be drawn using the foreground pixel value. 
(XSetFillStyle) 


Value of the £111 style member eS a GC: specifies that 
graphics should be drawn using the foreground pixel value 
masked by stipple. (xSetFillStyle) 


Value of the £il1 style member of a GC: specifies that 
graphics should be drawn using the tile pixmap. (xSet- 
FillStyle) 

Use if writing extension. 

Specifies that any FocusIn and FocusOut events are to be 


selected for this window. FocusIn and FocusOut events 
report changes in keyboard focus. (XSelect Input) 

Event type. 

Event type. 

Internal to Xlib. 

Reports that, using the specified font, the string would be 
drawn left to right. (XQueryFont, XQueryTextExtents, 
XQueryTextExtents16, XTextExtents, XText— 
Extents16) 

Reports that, using the specified font, the string would be 
drawn right to left. (XQueryFont, XQueryTextExtents, 
XQueryTextExtents1l6, XTextExtents, XText— 
Extents16) 

Specifies that window contents should always be discarded 


after a size change. (XChangeWindowAttributes, 
XCreateWindow) 


Mask to set the arc_mode component of a GC. (xChangeGc, 
XCopyGC, XCreateGC) 


Mask to set the background component of a GC. (xChange- 
GC, XCopyGC, XCreateGC) 


Mask to set the cap_style component of a GC. (xChange- 
GC, XCopyGC, XCreateGC) 


Mask to set the clip_mask component of a GC. (XChange- 
GC, XCopyGC, XCreateGC) 


Mask to set the clip x origin of the clip mask. 
(XChangeGC, XCopyGC, XCreateGC) 


Mask to set the clip _y origin of the clip mask. 
(XChangeGC, XCopyGC, XCreateGC) 


Mask to set the dashes component of a GC. (XChangeGCc, 
XCopyGC, XCreateGC) 
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GCDashOffset 
GCFillRule 
GCFillStyle 

GCFont 

GCForeground 
GCFunction 
GCGraphicsExposures 
GCJoinStyle 


GCLastBit 
GCLineStyle 


Rs, 

GCP laneMask 
GCStipple 
GCSubwindowMode 
GCTile 
GCTileStipXOrigin 
GCTileStipYOrigin 
GrabFrozen 


GrabInvalidTime 


GrabModeAsync 
GrabModeSync 


GrabNotViewable 


Mask to set the dash offset component of a GC. 
(XChangeGC, XCopyGC, XCreateGC) 


Mask to set the fill rule component of a GC. (XChange- 
GC, XCopyGC, XCreateGC) 


Mask to set the fi11 style component of aGC. (xChange- 
GC, XCopyGC, XCreateGC) 


Mask to set the font component of a GC. (XChangeGC, 
XCopyGC, XCreateGC) 


Mask to set the foreground component of a GC. (XChange- 
GC, XCopyGC, XCreateGC) 


Mask to set the function component of a GC. (XChangeGC, 
XCopyGC, XCreateGC) 


Mask to set the graphics exposures component of a GC. 
(XChangeGC, XCopyGC, XCreateGC) 


Mask to set the join_style component of aGC. (XChange- 
GC, XCopyGC, XCreateGC) 


Higher than last GC mask value. 


Mask to set the line style component of aGC. (XChange- 
GC, XCopyGC, XCreateGC) 


Mask to set the line width component of aGC. (XChange- 
GC, XCopyGC, XCreateGC) 


Mask to set the plane_mask component of a GC. (XChange- 
GC, XCopyGC, XCreateGC) 


Mask to set the st ipple component of a GC. (XChangeGC, 
XCopyGC, XCreateGC) 


Mask to set the subwindow mode component of a GC. 
(XChangeGC, XCopyGC, XCreateGC) 


Mask to set the tile component of a GC. (XChangeGc, 
XCopyGC, XCreateGC) 


Mask to set the ts_x origin component of a GC. 
(XChangeGC, XCopyGC, XCreateGC) 


Mask to set the ts_y origin component of a GC. 
(XChangeGC, XCopyGC, XCreateGC) 


Specifies that the pointer is frozen by an active grab of another 
client. (XGrabKeyboard, XGrabPointer) 


Specifies that the indicated grab time is involved (earlier than 
the last keyboard grab time or later than the current server 
time). (XGrabKeyboard, XGrabPointer) 


Specifies the pointer or keyboard mode. (XGrabButton, 
XGrabKey, XGrabKeyboard, XGrabPointer) 


Specifies the pointer or keyboard mode. (XGrabButton, 
XGrabKey, XGrabKeyboard, XGrabPointer) 


Specifies that the grab window is not viewable. (XGrab- 
Keyboard, XGrabPointer) 
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GrabSuccess 


GraphicsExpose 
GravityNotify 
GrayScale 


GXand 


GXandInverted 
GXandReverse 


GXclear 

GXcopy 
GXcopyInverted 
GXequiv 


GXinvert 


GXnand 


GXnoop 


GXnor ~ 


GXor 


GXorInverted 
GXorReverse 


GXset 


GXxor 


HIJ 


HeightValue 


HostDelete 
HostInsert 


IconicState 


IconMaskHint 
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Specifies a successful pointer or keyboard grab. (xGrab- 
Keyboard, XGrabPointer) 

Event type. 

Event type. 


Visual class, read/write. (XGetVisualInfo, XMatch- 
VisualInfo) 


Value of the function member of the GC: used with source 
and destination pixels to generate final destination pixel val- 
ues: src AND dst. (XChangeGC, XCreateGC, XSet- 
Function) 


(NOT src) AND dst. (KChangeGC, XCreateGC, XSet- 
Function) 


src AND (NOT dst). (XChangeGC, XCreateGC, XSet- 
Function) 


Set dst to 0. (XChangeGC, XCreateGC, XSetFunction) 
src. (XChangeGC, XCreateGC, XSetFunction) 
(NOT src). (XChangeGC, XCreateGC, XSetFunction) 


(NOT src) XOR dst. (XChangeGC, XCreateGC, XSet- 
Function) 


(NOT dst). (xChangeGC, XCreateGC, XSetFunction) 


(NOT src) OR (NOT dst). (XChangeGC, XCreateGC, xSet- 
Function) 


dst. (XChangeGC, XCreateGC, XSetFunction) 


(NOT src) AND (NOT dst). (XChangeGc, XCreateGCc, 
XSetFunction) 


src OR dst. (XChangeGC, XCreateGC, XSetFunction) 


(NOT src) OR dst. (xChangeGC, XCreateGC, xXSet- 
Function) 


src OR (NOT dst). (xChangeGc, XCreateGC, XSet- 
Function) 


set pixel. (XChangeGC, XCreateGC, XSetFunction) 
src XOR dst. (XChangeGC, XCreateGC, XSetFunct ion) 


Represents a user-specified window height in the standard 
window geometry string. (XxParseGeomet ry) 


Used internally to distinguish XAddHost and XRemoveHost. 
Used internally to distinguish XAddHost and XRemoveHost. 


Indicates that the client wants to be iconified when the top- 
level window is mapped. (Value for initial state mem- 
ber of XWMHints.) 


In the XA_WM_HINTS property, the icon pixmap mask mask 
communicates to the window manager a bitmap that deter- 
mines which pixels in icon pixmap are drawn on the icon 
window. (XGetWMHints, XSet WMHints) 
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IconPixmapHint 


IconPositionHint 


IconWindowHint 


IgnoreState 


InactiveState 


IncludeInferiors 


InputFocus 


InputHint 


InputOnly 


InputOutput 


IsCursorKey 
IsFunctionkey 
IsKeypadKey 
IsMiscFunctionkey 
IsModifierKey 
IsPFKey 
IsUnmapped 


IsUnviewable 


IsViewable 


JoinBevel 


In the XA_WM HINTS property, the icon pixmap mask commu- 
nicates to the window manager the pattern used to distinguish 
this icon from other clients. (XGetWMHints, XSetWMHints) 


In the XA_WM HINTS property, the position mask communi- 
cates to the window manager the preferred initial position of 
the icon. (XGetWMHints, XSetWMHints) 


In the XA_WM_HINTS property, the icon window mask commu- 
nicates to the window manager that icon_window contains a 
window that should be used instead of creating a new one. 
(XGetWMHints, XSetWMHints) 


Indicates that the client wants the window manager to ignore 
this window. (Value for initial_state member of 
XWMHints.) 


Indicates that the client wants to be inactive when the top-level 
window is mapped. Obsolete in R4. (Value for ini- 
tial_state member of XwMHints.) 


Value of the subwindow_mode member of the GC: specifies 
that graphics requests will draw through viewable children. 
(XSet SubwindowMode) 


Specifies that the event will be sent to the focus window, 
regardless of the position of the pointer. (XSendEvent) 


In the XA_WM HINTS property, the input member mask com- 
municates to the window manager the keyboard focus model 
used by the application. (XGetWMHints, XSetWMHints) 


InputOn1ly is a window class in which windows may receive 
input but may not be used to display output. (XCreate- 
Window) 


InputOutput is a window class in which windows may 
receive input and may be used to display output. (xCreate- 
Window) 


Keysym class macro. 
Keysym class macro. 
Keysym class macro. 
Keysym class macro. 
Keysym class macro. 
Keysym class macro. 


Means that the window is unmapped. (XGetWindow- 
Attributes) 


Means that the window is mapped but is unviewable because 
some ancestor is unmapped. (XGetWindowAttributes) 


Means that the window is currently viewable. (xGetWindow- 
Attributes) 


Value of the join style member of a GC: specifies Cap- 
Butt enpoint styles, with the triangular notch filled. (xset- 
LineAttributes) 
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JoinMiter 


JoinRound 


KL 


KBAutoRepeatMode 
KBBellDuration 
KBBellPercent 
KBBellPitch 


KBKey 


KBKeyClickPercent 
KBLed 
KBLedMode 


KeymapNotify 
KeymapStateMask 


KeyPress 


KeyPressMask 


KeyRelease 


KeyReleaseMask 


LASTEvent 
LastExtensionError 
LeaveNotify 


LeaveWindowMask 
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Value of the join style member of a GC: specifies that the 
outer edges of the two lines should extend to meet at an angle. 
(XSetLineAttributes) 

Value of the join style member of a GC: specifies that the 
lines should be joined by a circular arc with diameter equal to 
the line width, centered on the join point. (xXSetLine- 
Attributes) 


Mask to. specify keyboard auto-repeat preferences. 
(XChangeKeyboardControl, XGetKeyboardControl) 


Mask to specify keyboard bell-duration preferences. 
(XChangeKeyboardControl, XGetKeyboardControl) 


Mask to specify keyboard base-volume preferences. 
(XChangeKeyboardControl, XGetKeyboardControl) 


Mask to specify keyboard bell-pitch preferences. (xChange- 
KeyboardControl, XGetKeyboardControl) 


Mask to specify the keycode of the key whose auto-repeat sta- 
tus will be changed to the setting specified by 
auto repeat mode. (XChangeKeyboardControl, XGet- 
KeyboardControl) 


Mask to set keyboard key click-volume preferences. 
(XChangeKeyboardControl, XGetKeyboardControl) 


Mask to specify keyboard led preferences. (XChange- 
KeyboardControl, XGetKeyboardControl) 


Mask to specify keyboard led_mode preferences. (XChange- 
KeyboardControl, XGetKeyboardControl) 


Event type. 


Specifies that any KeymapNot ify events are to be selected for 
this window. A KeymapNot ify event notifies the client about 
the state of the keyboard when the pointer or keyboard focus 
enters a window. (XSelect Input) 


Event type. 


Specifies that any KeyPress events are to be selected for this 
window. A KeyPress event reports that a keyboard key has 
been pressed. (XSelect Input) 


Event type. 


Specifies that any KeyRelease events are to be selected for 
this window. A KeyRelease event reports that a keyboard 
key has been released. (xSelect Input) 


Bigger than any event type value. For extensions. 
Use if writing extension. 
Event type. 


Specifies that any LeaveNotify events are to be selected for 
this window. A LeaveNot ify event reports when the pointer 
leaves the window. (XSelect Input) 


Xlib Reference Manual 


LedModeOff 


LedModeOn 


LineDoubleDash 


LineOnOffDash 


LineSolid 


LockMap Index 


LockMask 


LowerHighest 


LSBFirst 


M 
MapNotify 
MappingBusy 


MappingFailed 
MappingKeyboard 
MappingModifier 


MappingNotify 
MappingPointer 


MappingSuccess 


- MapRequest 


Value of led mode: specifies that the states of all the lights 
are not changed. (XChangeKeyboardControl, XGet- 
KeyboardControl) 
Value of led mode: specifies that the states of all the lights 
are changed. (XChangeKeyboardControl, XGet- 
KeyboardControl) 


Value of the line style member of a GC: specifies that 
dashes are drawn with the foreground pixel value and gaps 
with the background pixel value. (XSet LineAttributes) 


Value of the line style member of a GC: specifies that 
only the dashes are drawn with the foreground pixel value, and 
cap style applies to each dash. (XSetLineAttributes) 


Value of the line style member of a GC: specifies that the 
full path of the line is drawn using the foreground pixel value. 
(XSetLineAttributes) 

Identifies one of eight modifiers to which keycodes can be 
mapped. (XDeleteModifiermapEntry, XGetModifier- 
Mapping, XInsertModifiermapEntry, XLookupKeysyn, 
XSetModifierMapping) 

Specifies a modifier keymask for XGrabButton, XGrabKey, 
XUngrabButton, and XUngrabKey, and for the results of 
XQueryPointer. 

Specifies that the stacking order of children should be circu- 
lated down. (XCirculateSubwindows) 

In image structure, specifies the byte order used by VAXes. 
(XCreateImage) 


Event type. 


Specifies that, in pointer or modifier mapping, no modifiers 
were changed because new keycodes for a modifier differ from 
those currently defined and any (current or new) keys for that 
modifier are in a down state. (XSetModifierMapping, 
XSetPointerMapping) 

Specifies that pointer or modifier mapping failed. (xSet- 
ModifierMapping, XSetPointerMapping) 


In a MappingNotify event, reports that keyboard mapping 
was changed. 


In a MappingNotify event, reports that keycodes were set to 
be used as modifiers. 


Event type. 


In a MappingNotify event, reports that pointer button map- 
ping was set. 

Specifies that pointer or modifier mapping succeeded. (xSet- 
ModifierMapping, XSetPointerMapping) 


Event type. 
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MessageHint 


Mod1MapIndex 


Mod1Mask 


Mod2Map Index 


Mod2Mask 


Mod3MapIndex 


Mod3Mask 


Mod4MapIndex 


Mod4Mask 


Mod5MapIndex 


Mod5Mask 


MotionNotify 
MSBFirst 


N 


NoEventMask 


NoExpose 


Nonconvex 
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In the XA_WM HINTS property, the message member mask 
communicates to the window manager the <??what??>. 
(XGetWMHints, XSetWMHints) 


Identifies one of eight modifiers to which keycodes can be 
mapped. (XDeleteModifiermapEntry, XGetModifier- 
Mapping, XInsertModifiermapEntry, XLookupKeysym, 
XSetModifierMapping) 


Specifies a modifier keymask for XGrabButton, XGrabKey, 
XUngrabButton, and XUngrabKey, and for the results of 
XQueryPointer. 


Identifies one of eight modifiers to which keycodes can be 
mapped. (XDeleteModifiermapEntry, XGetModifier- 
Mapping, XInsertModifiermapEntry, XLookupKeysym, 
XSetModifierMapping) 


Specifies a modifier keymask for XGrabButton, XGrabKey, 
XUngrabButton, and XUngrabKey, and for the results of 
XQueryPointer. 


Identifies one of eight modifiers to which keycodes can be 
mapped. (XDeleteModifiermapEntry, XGetModifier- 
Mapping, XInsertModifiermapEntry, XLookupKeysym, 
XSetModifierMapping) 


Specifies a modifier keymask for xGrabButton, XGrabKey, 
XUngrabButton, and XUngrabKey, and for the results of 
XQueryPointer. 


Identifies one of eight modifiers to which keycodes can be 
mapped. (XDeleteModifiermapEntry, XGetModifier- 
Mapping, XInsertModifiermapEntry, XLookupKeysym, 
XSetModifierMapping) 


Specifies a modifier keymask for XGrabButton, XGrabKey, 
XUngrabButton, and XUngrabKey, and for the results of 
XQueryPointer. 


Identifies one of eight modifiers to which keycodes can be 
mapped. (XDeleteModifiermapEntry, XGetModifier- 
Mapping, XInsertModifiermapEntry, XLookupKeysym, 
XSetModifierMapping) 


Specifies a modifier keymask for XGrabButton, XGrabKey, 
XUngrabButton, and XUngrabKey, and for the results of 
XQueryPointer,. 


Event type. 


In image structure, specifies the byte order used by 68000-fam- 
ily systems. (XCreate Image) 


Specifies that no events are to be selected for this window. 
(XSelect Input) 


Event type. 


Specifies that a polygon’s path does not self-intersect but that 
the polygon is not wholly convex. (XFil1Polygon) 
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None 


NormalState 


NorthEastGravity 


NorthGravity 


NorthWestGravity 


NoSymbol 
NotifyAncestor 


NotifyDetailNone 


NotifyGrab 
NotifyHint 


NotifyInferior 


NotifyNone 


NotifyNonlinear 


NotifyNonlinear- 
Virtual 


NotifyNormal 


NotifyPointer 
NotifyPointerRoot 


-NotifyUngrab 


Specifies a universal null resource or null atom. 


Indicates that the client wants its top-level window visible. 
(Value for initial state member of XWMHints.) 


When a window is resized, specifies the new location of the 
contents or the children of the window. (XChangeWindow- 
Attributes, XCreateWindow) 


When a window is resized, specifies the new location of the 
contents or the children of the window. (XChangeWindow- 
Attributes, XCreateWindow) 


When a window is resized, specifies the new location of the 
contents or the children of the window. (XChangeWindow- 
Attributes, XCreateWindow) 


Specifies the keysym for no symbol. 


In EnterNotify, FocusIn, FocusOut, and LeaveNotify 
events, specifies the hierarchical relationship of the origin and 
destination windows. 


In EnterNotify, FocusIn, FocusOut, and LeaveNotify 
events, specifies the hierarchical relationship of the origin and 
destination windows. 


In EnterNotify, FocusIn, FocusOut, and LeaveNotify 
events, specifies that the keyboard or pointer was grabbed. 


In a MotionNotify event, a hint that specifies that 
PointerMot ionHintMask was selected. 


In EnterNotify, FocusIn, FocusOut, and LeaveNotify 
events, specifies the hierarchical relationship of the origin and 
destination windows. 


In EnterNotify, FocusIn, FocusOut, and LeaveNotify 
events, specifies the hierarchical relationship of the origin and 
destination windows. 


In EnterNotify, FocusIn, FocusOut, and LeaveNotify 
events, specifies the hierarchical relationship of the origin and 
destination windows. 


In EnterNotify, FocusIn, FocusOut, and LeaveNotify 
events, specifies the hierarchical relationship of the origin and 
destination windows. 


In a MotionNotify event, a hint that specifies that the event 
is real but may not be up to date since there may be many more 
later motion events on the queue. In EnterNotify, Focus-— 
In, FocusOut, and LeaveNotify events, specifies that the 
keyboard was not grabbed at the time the event was generated. 


In FocusIn and FocusOut events, specifies the hierarchical 
relationship of the origin and destination windows. 


In FocusIn and FocusOut events, specifies the hierarchical 
relationship of the origin and destination windows. 


In EnterNotify, FocusIn, FocusOut, and LeaveNotify 
events, specifies that the keyboard or pointer was ungrabbed. 
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NotifyVirtual 


NotifyWhileGrabbed 
NotUseful 


NoValue 


OP 


Opposite 


OwnerGrabButtonMask 


PA11Hints 
ParentRelative 
PAspect 
PBaseSize 
PlaceOnBottom 
PlaceOnTop 
PMaxSize 


PMinSize 


PointerMotionHintMask 


PointerMotionMask 


PointerRoot 


PointerWindow 


PPosition 
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In EnterNotify, FocusIn, FocusOut, and LeaveNotify 
events, specifies the hierarchical relationship of the origin and 
destination windows. 


EnterNotify, FocusIn, FocusOut, LeaveNotify mode. 


Specifies that maintaining the contents of an unmapped win- 
dow is  ummecessary. (XChangeWindowAttributes, 
XCreateWindow) 


Mask used by XParseGeomet ry; returns those set by user. 


Specifies that, if the indicated sibling occludes the indicated 
window, the window is placed at the top of the stack; if the 
window occludes the sibling, the window is placed at the bot- 
tom of the stack. (XConfigureWindow) 


Controls the distribution of button events to a client between 
ButtonPress and ButtonRelease events. (XSelect- 
Input) 

Specifies that the program determined the window hints. 
(XGetNormalHints, XSetNormalHints) 


Specifies that a window’s background will be repainted when 
itis moved. (XSetWindowBackgroundPixmap) 


Specifies that the program determined the min and max aspect 
ratio. (XGetNormalHints, XSetNormalHints) 


Specifies that the program determined the base window size. 
(XGetNormalHints, XSetNormalHints) 


In a CirculateNotify event, specifies that the window will 
be placed on the bottom of the stack. 


In a CirculateNotify event, specifies that the window will 
be placed on the top of the stack. 


Specifies that the program determined the maximum desired 
window size. (XGetNormalHints, XSetNormalHints) 


Specifies that the program determined the minimum desired 
window size. (XGetNormalHints, XSetNormalHints) 


Specifies that the server should send only one Mot ionNotify 
event when the pointer moves. Used in concert with other 
pointer motion masks to reduce the number of events gen- 
erated. (XSelect Input) 


Specifies that any pointer MotionNotify events are to be 
selected for this window. A MotionNotify event reports 
pointer movement. (XSelect Input) 


Specifies the ID of the window that is the current keyboard 
focus. (XGet InputFocus, XSet InputFocus) 


Specifies that the event will be sent to the window that the 
pointer is in. (XSendEvent) 


Specifies that the program determined the window position. 
(XGetNormalHints, XSetNormalHints) 
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PreferBlanking 
PResizelInc 


PropertyChangeMask 


PropertyDelete 
PropertyNewValue 


PropertyNotify 
PropModeAppend 


PropModePrepend 
PropModeReplace 
PseudoColor 
PSize 


PWinGravity 


R 


RaiseLowest 
RectangleIn 
RectangleOut 
RectanglePart 
ReleaseByFreeing 
Colormap 


ReparentNotify 
ReplayKeyboard 


ReplayPointer 


Specifies screen saver screen blanking. (XGetScreenSaver, 
XSet ScreenSaver) 


Specifies that the program determined the window resize 
increments. (XGetNormalHints, XSetNormalHints) 


Specifies that any PropertyNotify events are to be selected 
for this window. A PropertyNotify event indicates that a 
property of a certain window was changed or deleted. 
(XSelect Input) 

In a PropertyNotify event, specifies that a property of a 
window was deleted. 

In a PropertyNotify event, specifies that a property of a 
window was changed. 

Event type. 

Appends the data onto the end of the existing data. 
(XChangeProperty) 

Inserts the data before the beginning of the existing data. 
(XChangeProperty) 


Discards the previous property and stores the new data. 
(XChangeProperty) 


Visual class, read/write. 
VisualiInfo) 


Specifies that the program determined the window size. 
(XGetNormalHints, XSetNormalHints) 


Specifies that the program determined the window gravity. 
(XGetNormalHints, XSetNormalHints) 


(XGetVisualInfo, XMatch- 


Specifies that the stacking order of children should be circu- 
lated up. (XCirculateSubwindows) 


Specifies that the rectangle is inside the region. (XRect- 
InRegion) 

Specifies that the rectangle is completely outside the region. 
(XRect InRegion) 

Specifies that the rectangle is partly inside the region. 
(XRect InRegion) 


Value for the killid field of xStandardColormap. 
(XSetRGBColormap and XGet RGBColormap) 


Event type. 


Specifies the conditions under which queued events are 
released: ReplayKeyboard has an effect only if the key- 
board is grabbed by the client and thereby frozen as the result 
of an event. (XAllowEvents) 


Specifies the conditions under which queued events are 
released: ReplayPointer has an effect only if the pointer is 
grabbed by the client and thereby frozen as the result of an 
event. (XAllowEvents) 
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ResizeRedirectMask 


ResizeRequest 


RetainPermanent 


RetainTemporary 


RevertToNone 
RevertToParent 


RevertToPointerRoot 


S 


ScreenSaverActive 
ScreenSaverReset 


SelectionClear 
SelectionNotify 
SelectionRequest 


SetModeDelete 
SetModeInsert 


ShiftMapIndex 


ShiftMask 


SouthEastGravity 
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Specifies that any ResizeRequest events should be selected 
for this window when some other client (usually the window 
manager) attempts to resize the window on which this mask is 
selected. (XSelect Input) 

Event type. 

Specifies that resources associated with a client/server connec- 
tion live on until a call to XKillClient. If AllTemporary 
is specified in XKil1Client, the resources of all clients that 
have terminated in RetainTemporary are destroyed. 
<??vol2 unclear — XKillClient doc??> (XSetClose- 
DownMode) 

Specifies that resources associated with a client/server connec- 
tion live on until a call to XKillClient. If AllTemporary 
is specified in XKil1Client, the resources of all clients that 
have terminated in RetainTemporary are destroyed. (xSet- 
CloseDownMode) 


Specifies that there is no backup keyboard focus window. 
(XGet InputFocus, XSet InputFocus) 


Specifies that the backup keyboard focus window is the parent 
window. (XGet InputFocus, XSet InputFocus) 


Specifies that the backup keyboard focus window is the 
pointer root window. (XGet InputFocus, XSet InputFocus) 


Specifies that the screen saver is to be activated. (xForce- 
ScreenSaver) 


Specifies that the screen saver is to be turned off. (XForce- 
ScreenSaver) 


Event type. 
Event type. 
Event type. 


Specifies that a subwindow is to be deleted from the client’s 
save-set. (XChangeSaveSet) 


Specifies that a subwindow is to be added to the client’s save- 
set. (XChangeSaveSet) 


Identifies one of eight modifiers to which keycodes can be 
mapped. (XDeleteModifiermapEntry, XGetModifier- 
Mapping, XInsertModifiermapEntry, XLookupKeysym, 
XSetModifierMapping) 


Specifies a modifier keymask for XGrabButton, XGrabKey, 
XUngrabButton, and XUngrabKey, and for the results of 
XQueryPointer. 


When a window is resized, specifies the new location of the 
contents or the children of the window. (XChangeWindow- 
Attributes, XCreateWindow) 
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SouthGravity 


SouthWestGravity 


StateHint 


StaticColor 


StaticGravity 


StaticGray 


StippleShape 


StructureNotifyMask 


SubstructureNotify-— 
Mask 


SubstructureRedirect— 
Mask 


Success 


SyncBoth 


SyncKeyboard 


SyncPointer 


When a window is resized, specifies the new location of the 
contents or the children of the window. (xChangeWindow- 
Attributes, XCreateWindow) 


When a window is resized, specifies the new location of the 
contents or the children of the window. (XChangeWindow- 
Attributes, XCreateWindow) 


In the XA_WM_HINTS property, the window state mask commu- 
nicates to the window manager whether the client prefers to be 
in iconified, zoomed, normal, or inactive state. (xGet- 
WMHints, XSetWMHints) 


Visual class, read-only. (XGetVisualInfo, XMatch- 
VisualiInfo) 


Specifies that window contents should not move relative to the 
origin of the root window. (XChangeWindowAttribute, 
XCreateWindow) 


Visual class, read-only. (XGetVisualInfo, XMatch- 
VisualInfo) 


Specifies the “best” supported stipple size available on the dis- 
play hardware. (XQueryBestSize) 


Selects a group of event types (CirculateNotify, 
ConfigureNotify, DestroyNotify, GravityNotify, 
MapNotify, ReparentNotify, UnmapNotify) that report 
when the state of a window has changed. (XSelect Input) 


Selects a group of event types (CirculateNotify, 
ConfigureNotify, DestroyNotify, GravityNotify, 
MapNotify, ReparentNotify, UnmapNotify) that report 
when the state of a window has changed, plus an event that 
indicates that a window has been created. It monitors all the 
subwindows of the window specified in the xSelect Input 
call that used this mask. 


The three event types selected by this mask (Circulate- 
Request, ConfigureRequest, and MapRequest) can be 
used by the window manager to intercept and cancel window- 
configuration-changing requests made by other clients. 
(XSelect Input) 


Indicates that everything is okay. 


Specifies that pointer and keyboard event processing resumes 
normally, until the next ButtonPress, ButtonRelease, 
KeyPress, Or KeyRelease event, if the pointer and the key- 
board are both frozen by the client when XAllowEvents is 
called with SyncBoth. (XAllowEvents) 


Specifies that key event processing resumes normally, until the 
next ButtonPress.Or ButtonRelease event, if the key- 
board is frozen by the client when XAllowEvents is called 
with SyncPointer. (XAllowEvents) 


Specifies that pointer event processing resumes normally, until 
the next ButtonPress or ButtonRelease event, if the 
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TU 
TileShape 


TopIif 


TrueColor 
UnmapGravity 
UnmapNotify 
Unsorted 
USPosition 


USSize 


Vw 


VisibilityChangeMask 


VisibilityFully- 
Obscured 


VisibilityNotify 
VisibilityPartially- 
Obscured 


VisibilityUnobscured 


VisualAl1Mask 


VisualBitsPerRGBMask 


VisualBlueMaskMask 


VisualClassMask 
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pointer is frozen by the client when XAllowEvents is called 
with SyncPointer. (XAllowEvents) 


Specifies the “best” supported tile size available on the display 
hardware. (XQueryBestSize) 

Specifies that the indicated window is placed on top of the 
stack if it is obscured by the indicated sibling window. 
(XConfigureWindow) 
Visual class, read-only. 
VisualInfo) 


Specifies that the child is unmapped when the parent is resized 
and an UnmapNotify event is generated. (KChangeWindow- 
Attributes, XCreateWindow) 


Event type. 


Specifies that the ordering of rectangles specified for a particu- 
lar GC is arbitrary. (XSetClipRectangles) 


Specifies that the user provided a position value for the win- 
dow. (XGetNormalHints, XSetNormalHints) 


Specifies that the user provided a size value for the window. 
(XGetNormalHints, XSetNormalHints) 


(XGetVisualInfo, XMatch- 


Specifies that any VisibilityNotify events are to be 
selected for this window, except when the window becomes 
not viewable. A VisibilityNotify event reports any 
changes in the window’s visibility. (XSelect Input) 


In a VisibilityNotify event, specifies that the window is 
fully obscured. 


Event type. 


In a VisibilityNotify event, specifies that the window is 
partially obscured. 


In a VisibilityNotify event, specifies that the window is 
unobscured. 


Determines which elements in a template are to be matched. 
(xGet Visual Info, XMatchVisual Info) 


Determines which elements in a template are to be matched. 
(XGet Visual Info, XMatchVisualInfo) 


Determines which elements in a template are to be matched. 
(xGet Visual Info, XMatchVisualInfo) 


Determines which elements in a template are to be matched. 
(xXGet VisualInfo, XMatchVisualInfo) 
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VisualColormapSize- 
Mask 
VisualDepthMask 
VisualGreenMaskMask 
VisualIDMask 
VisualNoMask 
VisualRedMaskMask 


VisualScreenMask 


WestGravity 


WhenMapped 


WidthValue 


WindingRule 


WindowGroupHint 


WithdrawnState 


X 


XA_ARC 
XA_ATOM 
XA_BITMAP 


XA_CAP HEIGHT 
XA_CARDINAL 


XA_COLORMAP 


XA_COPYRIGHT 
XA_CURSOR 


Determines which elements in a template are to be matched. 
(XGet Visual Info, XMatchVisualInfo) 


Determines which elements in a template are to be matched. 
(XGet VisualInfo, XMatchVisualInfo) 


Determines which elements in a template are to be matched. 
(XGet VisualInfo, XMatchVisualInfo) 


Determines which elements in a template are to be matched. 
(XGetVisualInfo, XMatchVisualInfo) 


Determines which elements in a template are to be matched. 
(XGet VisualInfo, XMatchVisualInfo) 


Determines which elements in a template are to be matched. 
(XGetVisudlInfo, XMatchVisualInfo) 


Determines which elements in a template are to be matched. 
(XGet VisualInfo, XMatchVisualInfo) 


When a window is resized, specifies the new location of the 
contents or the children of the window. (XChangeWindow- 
Attributes, XCreateWindow) 


Advises the server to maintain contents of obscured regions 
when the window is unmapped. (XChangeWindow- 
Attributes, XCreateWindow) 


Represents a user-specified window width in the standard win- 
dow geometry string. (XParseGeometry) 


Value of the £111 rule member of aGC: specifies that areas 
overlapping an odd number of times should be part of the 
region. (XPolygonRegion, XSetFillRule) 


In the XA_WM_HINTS property, the group property mask com- 
municates to the window manager that the client has multiple 
top-level windows. (XGetWMHints, XSetWMHints) 


Indicates that the client wants neither its top-level nor its icon 
visible. (Value for initial_state member of XWMHints.) 


Specifies the atom of the type property that specifies the 
desired format for the data. (KConvertSelection) 


Specifies the atom of the type property that specifies the 
desired format for the data. (XConvertSelection) 


Specifies the atom of the type property that specifies the 
desired format for the data. (xConvertSelection) 


Predefined type atom. 


Specifies the atom of the type property that specifies the 
desired format for the data. (xConvertSelection) 


Specifies the atom»of the type property that specifies the 
desired format for the data. (xConvertSelection) 


Predefined font atom. 


Specifies the atom of the type property that specifies the 
desired format for the data. (XConvertSelection) 
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XA_CUT_BUFFERO 
XA_CUT_BUFFER1 
XA_CUT_BUFFER2 
XA_CUT_BUFFER3 
XA_CUT_BUFFER4 
XA_CUT BUFFERS 
XA_CUT_BUFFER6 
XA_CUT_BUFFER7 
XA_DRAWABLE 


XA_END_SPACE 
XA_FAMILY NAME 
XA_FONT 


XA_FONT_NAME 
XA_FULL_NAME 
XA_INTEGER 


XA_ITALIC ANGLE 


XA_LAST PREDEFINED 
XA_MAX SPACE 
XA_MIN. SPACE 
XA_NORM SPACE 
XA_NOTICE 
XA_PIXMAP 


XA_POINT 
XA_POINT SIZE 


XA_PRIMARY 


XA_QUAD WIDTH 
XA_RECTANGLE 
XA_RESOLUTION 


XA_RESOURCE MANAGER 
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Represents a predefined cut buffer atom. 
Represents a predefined cut buffer atom. 
Represents a predefined cut buffer atom. 
Represents a predefined cut buffer atom. 
Represents a predefined cut buffer atom. 
Represents a predefined cut buffer atom. 
Represents a predefined cut buffer atom. 
Represents a predefined cut buffer atom. 


Specifies the atom of the type property that specifies the 
desired format for the data. (XConvertSelection) 


Specifies the additional spacing at the end of sentences. 
Predefined font atom. 


Specifies the atom of the type property that specifies the 
desired format for the data. (XConvertSelection) 


Predefined font atom. _ 
Predefined font atom. 


Specifies the atom of the type property that specifies the 
desired format for the data. (XConvertSelection) 


Specifies the angle of the dominant staffs of characters in the 
font. 


Predefined font atom. 

Specifies the maximum interword spacing. 
Specifies the minimum interword spacing. 
Specifies the normal interword spacing. 
Predefined font atom. 


Specifies the atom of the type property that specifies the 
desired format for the data. (KConvertSelection) 


Specifies the atom of the type property that specifies the 
desired format for the data. (XConvert Selection) 


Specifies the point size of this font at the ideal resolution, 
expressed in tenths of a point. 


Specifies the primary built-in selection atom used in transfer- 
ring data between clients. 


“1 em” as in TeX but expressed in units of pixels. The width 
of an m in the current font and point size. 


Specifies the atom of the type property that specifies the 
desired format for the data. (xConvert Selection) 


Specifies the number of pixels per point at which this font was 
created. 


Specifies a predefined resource manager property containing 
default values for user preferences. 
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XA_RGB_BEST_ MAP 
XA_RGB_ BLUE MAP 
XA_RGB_COLOR MAP 
XA_RGB_ DEFAULT MAP 
XA_RGB GRAY MAP 
XA_RGB_GREEN MAP 
XA_RGB_RED MAP 
XA_SECONDARY 
XA_STRIKEOUT ASCENT 
XA_STRIKEOUT DESCENT 
XA_STRING 
XA_SUBSCRIPT X 
XA_SUBSCRIPT_ Y 
XA_SUPERSCRIPT X 


XA SUPERSCRIPT Y 


XA UNDERLINE POSITION 


Specifies a predefined colormap atom that defines the “best” 
RGB colormap available on the display. 


Specifies a predefined colormap atom that defines an all-blue 
colormap. 

Specifies the atom of the type property that specifies the 
desired format for the data. (XConvertSelection) 

Specifies a predefined colormap atom that defines part of the 
system default colormap. 

Specifies a predefined colormap atom that defines the “best” 
gray-scale colormap available on the display. 

Specifies a predefined colormap atom that defines an all-green 
colormap. 

Specifies a predefined colormap atom that defines an all-red 
colormap. 


Specifies the secondary built-in selection atom used in 
transferring data between clients. 


Specifies the vertical extents (in pixels) for boxing or voiding 
characters. 


Specifies the vertical extents (in pixels) for boxing or voiding 
characters. 


Specifies the atom of the type property that specifies the 
desired format for the data. (XConvertSelection) 


Specifies the X offset (in pixels) from the character origin 
where subscripts should begin. 

Specifies the Y offset (in pixels) from the character origin 
where subscripts should begin. 

Specifies the X offset (in pixels) from the character origin 
where superscripts should begin. 

Specifies the Y offset (in pixels) from the character origin 
where superscripts should begin. 


Specifies the Y offset (in pixels) from the baseline to the top of 
the underline. 


XA_UNDERLINE_THICKNESS Specifies the thickness (in pixels) from the baseline to the top 


XA_VISUALID 


XA_WETGHT 


XA_WINDOW 


XA_WM CLASS 


of the underline. 


Specifies the atom of the ‘type property that specifies the 
desired format for the data. (XConvertSelection) 


Specifies the weight or boldness of the font, expressed as a 
value between 0 and 1000. 


Specifies the atom of the type property that specifies the 
desired format for the data. (KConvert Selection) 


The XA_WM_CLASS property is a string containing two null- 
separated elements, tes class and res name, that are 
meant to be used by clients both as a means of permanent iden- 
tification and as the handles by which both the client and the 
window manager obtain resources related to the window. 
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XA_WM CLIENT MACHINE 


XA_WM_COMMAND 


XA_WM HINTS 
XA_WM ICON NAME 


XA_WM ICON SIZE 
XA_WM NAME 

XA_WM NORMAL HINTS 
XA_WM SIZE HINTS 


XA_WM TRANSIENT FOR 


XA_WM ZOOM HINTS 


XA_X HEIGHT 


XCNOENT 
XCNOMEM 
XCSUCCESS 
XK _* 
XNegative 


XValue 


XYBitmap 


XYPixmap 
X_ PROTOCOL 
X_ PROTOCOL REVISION 
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The XA_WM CLIENT MACHINE property is a string forming 
the name of the machine running the client, as seen from the 
machine running the server. 


The XA_WM COMMAND property stores the shell command and 
arguments used to invoke the application. 


The XA_WM HINTS property contains hints stored by the win- 
dow manager that provide a means of communicating optional 
information from the client to the window manager. 


The XA_WM ICON NAME property is an uninterpreted string 
that the client wishes displayed in association with the window 
when it is iconified (for example, in an icon label). 


The window manager may set the XA_WM_ICON_SIZE prop- 
erty on the root window to specify the icon sizes it allows. 


The XA_WM NAME property is an uninterpreted string that the 
client wishes displayed in association with the window (for 
example, a window headline bar). 


The XA_WM NORMAL HINTS property is an XSizeHints 
structure describing the desired position and range of sizes that 
are preferable for each top-level window in normal state. 


The XA_WM SIZE HINTS property contains hints stored.. 


The XA_WM TRANSIENT FOR property is the ID of another 
top-level window. 


The XA_WM_ ZOOM HINTS property is an XSizeHints struc- 
ture describing the desired position and range of sizes that are 
preferable for each top-level window in a zoomed state. 


“1 ex” as in TeX but expressed in units of pixels, often the 
height of lower case x. 


Association table lookup return codes, No entry in table. 
Association table lookup return codes, Out of memory. 
Association table lookup return codes, No error. 
Keysyms, see Appendix H, Keysym Reference. 


Represents a user-specified negative X offset in the standard 
window geometry string. (XxParseGeomet ry) 


Represents a user-specified positive X offset in the standard 
window geometry string. (XParseGeomet ry) 


XYBitmap specified the format for an image. The data for an 
image is said to be in XYBitmap format if the bitmap is repre- 
sented in scan line order, with each scan line made up of multi- 


ples of the bitmap_unit and padded with meaningless bits. 
(XGet Image, XPut Image) 


Depth == drawable depth. (xGet Image, XPut Image) 
Current protocol version. 
Current minor revision. 


Xlib Reference Manual 


YZ 


YNegative 
YSorted 
YValue 


YXBanded 


YXSorted 


ZoomState 


ZPixmap 


Represents a user-specified negative Y offset in the standard 
window geometry string. (XParseGeomet ry) 

Specifies that rectangles specified for a particular GC are non- 
decreasing in their Y origin. (XSetClipRectangles) 
Represents a user-specified positive Y offset in the standard 
window geometry string. (XParseGeometry) 

Specifies that, in addition to the constraints of yxSorted, for 
every possible horizontal Y scan line, all rectangles that 
include that scan line have identical Y origins and X extents. 
(XSetClipRectangles) 

Specifies that rectangles specified for a particular GC are non- 
decreasing in their Y origin and that all rectangles with an 
equal Y origin are nondecreasing in their X origin. (xSet- 
ClipRectangles) 

Indicates that the client wants to be in zoomed state when the 
top-level window is mapped. Obsolete in R4. (Value for ini- 
tial_state member of XwMHints.) 


Depth == drawable depth. (xGet Image, XPut Image) 
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H 
Keysyms 


This appendix provides a list of keysyms and a brief description of each keysym. Keysyms, 
as you may remember, are the portable representation of the symbols on the caps of keys. 


The normal way to process a keyboard event is to use XLookupKeysym to determine the 
keysym or, if the application allows remapping of keys to strings, it may use XLookup-— 
String to get the ASCII string mapped to the key or keys pressed. This allows the applica- 
tion to treat keys in a simple and portable manner, and places the responsibility of tailoring 
the mapping between keys and keysyms on the server vendor.* 


Many keysyms do not have obvious counterparts on the keyboard, but may be generated with 
certain key combinations. You will need a table for each particular model of hardware you 
intend the program to work on, to tell you what key combination results in each keysym that 
is not present on the caps of the keyboard. For real portability, you will want to use only the 
keysyms that are supported on all vendors equipment you intend the program to be displayed 
on. 


The keysyms are defined in two standard include files: <X11/keysym.h> and <X11/keysym- 
def.h>. There are several families of keysyms defined in <X11/keysymdef.h>; LATIN1, 
LATIN2, LATIN3, LATIN4, KATAKANA, ARABIC, CYRILLIC, GREEK, TECHNICAL, 
SPECIAL, PUBLISHING, APL, HEBREW, and MISCELLANY. The <X/J/keysym.h> file 
specifies which families are enabled. Only the LATIN1, LATIN2, LATIN3, LATIN4, 
GREEK, and MISCELLANY families are enabled in the standard <X11/keysym.h> file, proba- 
bly because some compilers have an upper limit on the number of defined symbols that are 
allowed. 


The developers of X at MIT say that to the best of their knowledge the Latin, Kana, Arabic, 
Cyrillic, Greek, Technical, APL, and Hebrew keysym sets are from the appropriate ISO 
(International Standards Organization) and/or ECMA international standards. There are no 
Technical, Special nor Publishing international standards, so these sets are based on Digital 
Equipment Corporation standards. 


* While keycode information is not necessary for normal application programming, it may be necessary for writing 

certain programs that change the keycode to keysym mapping. If you are writing such an application, you will need 

~ to obtain a list of keycodes and their normal mappings from the system manufacturer. Any program that uses this 
mapping is not fully portable. : 
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H.1 


Keysyms are four byte long values. In the standard keysyms, the least significant 8 bits indi- 
cate a particular character within a set. and the next 8 bits indicate a particular keysym set. 
The order of the sets is important since not all the sets are complete. Each character set con- 
tains gaps where codes have been removed that were duplicates with codes in previous (that 
is, with lesser keysym set) character sets. 


The 94 and 96 character code sets have been moved to occupy the right hand quadrant (deci- 
mal 129 - 256), so the ASCII subset has a unique encoding across the least significant byte 
which corresponds to the ASCII character code. However, this cannot be guaranteed in the 
keysym sets of future releases and does not apply to all of the MISCELLANY set. 


As far as possible, keysym codes are the same as the character code. In the LATIN] to 
LATIN4 sets, all duplicate glyphs occupy the same position. However, duplicates between 
GREEK and TECHNICAL do not occupy the same code position. Thus, applications wishing 
to use the TECHNICAL character set must transform the keysym using an array. 


The MISCELLANY set is a miscellaneous collection of commonly occurring keys on key- 
boards. Within this set, the keypad symbols are generally duplicates of symbols found on 
keys on the alphanumeric part of the keyboard but are distinguished here because they often 
have distinguishable keycodes associated with them. 


There is a difference between European and US usage of the names Pilcrow, Paragraph, and 
Section, as shown in Table H-1. 


Table H-1. European vs. US usage of Pilcrow, Paragraph, and Section symbol names 











European name | Keysym in LATIN1 
Paragraph sign | XK section 
Pilcrow sign XK_paragraph 


X has adopted the names used by both the ISO and ECMA standards. Thus, XK_para- 
graph is what Europeans call the pilcrow sign, and XK_section is what they would call 
the paragraph sign. This favors the US usage. 


Section sign 
Paragraph sign 





Keysyms and Description 


Tables H-2 through H-7 list the six commonly available sets of keysyms (MISCELLANY, 
LATIN1 through LATIN4, and GREEK) and describe each keysym briefly. When necessary 
and possible, these tables show a representative character or characters that might appear on 
the cap of the key or on the screen when the key or keys corresponding to the keysym were 
typed. 
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Table H-2. MISCELLANY 


Keysym 





XK_BackSpace 
XK_Tab 
XK_Linefeed 
XK_Clear 
XK_Return 
XK_Pause 
XK_Escape 
XK_ Delete 
XK_ Multi key 
XK_Kanji 
XK_Home 

XK Left 

XK Up 

XK_ Right 
XK_Down 

XK_ Prior 
XK_Next 
XK_End 

XK_ Begin 
XK_ Select 
XK_ Print 
XK_Execute 
XK_Insert 
XK_Undo 

XK_ Redo 
XK_Menu 

XK Find 
XK_Cancel 
XK_ Help 
XK_Break 
XK_Mode_ switch 


XK_script_switch 


XK_Num_Lock 
XK_KP Space 
XK_KP_ Tab 
XK_KP Enter 
XRG SEE 
ARULKP EZ 

KK OKPEES 
 AKUKRE PES 
XK_KP_ Equal 
XK_KP Multiply 
XK_KP_ Add 
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Description 





Backspace, Back Space, Back Char 
Tab 

Linefeed, LF 

Clear 

Return, Enter 

Pause, Hold, Scroll Lock 
Escape 

Delete, Rubout _ 

Multi-key character preface 
Kanji, Kanji convert 

Home 

Left, move left, left arrow 
Up, move up, up arrow 

Right, move right, right arrow 
Down, move down, down arrow 
Prior, previous 

Next 

End, EOL 

Begin, BOL 

Select, mark 

Print 

Execute, run, do 

Insert, insert here 

Undo, oops 

Redo, again 

Menu 

Find, search 

Cancel, stop, abort, exit 
Help, question mark 

Break 

Mode switch, script switch, 
character set switch 

Alias for mode switch, script switch, 
character set switch 

Num Lock 

Keypad Space 

Keypad Tab 

Keypad Enter 

Keypad F1, PFl,a 

Keypad F2, PF2, b 

Keypad F3, PF3, c 

Keypad F4, PF4, d 

Keypad equals sign 

Keypad multiplication sign, asterisk 
Keypad plus sign 
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Table H-2, MISCELLANY (continued) 


Description 





XK_KP_ Separator Keypad separator, comma 


XK_KP_ Subtract Keypad minus sign, hyphen 
XK_KP Decimal Keypad decimal point, full stop 
XK_KP Divide Keypad division sign, solidus 
XK_KP_0 Keypad digit zero 
XK_KP_1 Keypad digit one 
XK KP 2 Keypad digit two 
XK_KP_ 3 Keypad digit three 
XK_KP 4 Keypad digit four 
XK_KP 5 Keypad digit five 
XK_KP_ 6 Keypad digit six 
XK_ KP 7 Keypad digit seven 
XK_KP 8 Keypad digit eight 
XK_KP 9 Keypad digit nine 
XK_F1 F1 function key 
XK_F2 F2 function key 
XK_F3 F3 function key 
XK_F4 F4 function key 
XK_F5 F5 function key 
XK_F6 F6 function key 
XK_F7 F7 function key 
XK_F8_ F8 function key 
XK_F9 F9 function key 
XK_F10 F10 function key 
XK_F11l F11 function key 
XK_L1 L1 function key 
XK_F12 F12 function key 
XK_L2 L2 function key 
XK_F13 F13 function key 
XK_L3 L3 function key 
XK_F14 F14 function key 
XK_L4 LA function key 
XK_F15 F15 function key 
XK_L5 LS function key 
XK_F16 F16 function key 
XK_L6 L6 function key 
XK_F17 F17 function key 
XK_L7 L7 function key 
XK_F18 F18 function key 
XK_L8 L8 function key 
XK_F19 F19 function key 
XK_L9 L9 function key 
XK_F20 F20 function key 
XK_L10 L10 function key 
XK_F21 F21 function key 
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Table H-2. MISCELLANY (continued) 





Keysym Description 
XK_R1 R1 function key 
XK_F22 F22 function key 
XK_R2 R2 function key 
XK_F23 F23 function key 
XK_R3 R3 function key 
XK_F24 F24 function key 
XK_R4 R4 function key 
XK_F25 F25 function key 
XK_R5 R5 function key © 
XK_F26 F26 function key 
XK_R6 R6 function key 
XK_F27 F27 function key 
XK_R7 R7 function key 
XK _F28 F28 function key 
XK_R8 R8 function key 
XK_F29. F29 function key 
XK_R9 R9 function key 
XK_F30 F30 function key 
MK RIO . R10 function key 
XK_F31 F31 function key 
XK_R11 R11 function key 
XK_F32 F32 function key pes 
XK_R12 R12 function key a 
XK_R13 F33 function key a 
XK F33 R13 function key = 
XK _F34 F34 function key : 
XK_R14 R14 function key 
XK_F35 F35 function key 
XK_R15 R15 function key 
XK_Shift_L Left Shift 
XK Shift _R Right Shift 
XK_Control_L Left Control 
XK_ Control R Right Control 
XK_Caps_Lock Caps Lock 
XK_ Shift Lock Shift Lock 
XK Meta _ L Left Meta 
XK_Meta R Right Meta 
XK _Alt_L Left Alt 
XK Alt _R Right Alt 
XK_ Super L Left Super 
XK_ Super R Right Super 
XK_Hyper_ L Left Hyper 
-XK_Hyper R Right Hyper 
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Table H-3. LATIN1 


Keysym 





XK_space 
XK_exclam 
XK_quotedb1 
XK_numbersign 
XK_ dollar 
XK_percent 
XK_ampersand 
XK_quoteright 
XK_parenleft 
XK_parenright 
XK_asterisk 
XK_plus 
XK_comma 
XK_minus 
XK_period 
XK_slash 
XK_0 

XK_1 

XK_2 

XK_3 

XK_4 

XK_5 

XK_6 

XK_7 

XK_8 

XK_9 
XK_colon 
XK_semicolon 
XK_less 
XK_equal 

XK_ greater 
XK_question 
XK_at 

XK_A 

XK_B 

XK_C 
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Space 
Exclamation point 
Quotation mark 
Number sign 
Dollar sign 
Percent sign 
Ampersand 
Apostrophe 

Left parenthesis 
Right parenthesis 
Asterisk 

Plus sign 
Comma 

Hyphen, minus sign 
Full stop 

Solidus 

Digit zero 

Digit one 

Digit two 

Digit three 

Digit four 

Digit five 

Digit six 

Digit seven 
Digit eight 

Digit nine 

Colon 
Semicolon 

Less than sign 
Equals sign 
Greater than sign 
Question mark 
Commercial at 
Latin capital A 
Latin capital B 
Latin capital C 
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Table H-3. LATIN1 (continued) 







Character 





















XK_D Latin capital D D 

XK_E Latin capital E E 

XK _F Latin capital F F 

XK_G Latin capital G G 

XK_H Latin capital H H 

XK_I Latin capital I I 

XK J Latin capital J -- J 

XK_K Latin capital K K 

XK_L Latin capital L L 

XK M Latin capital M M 

XK_N Latin capital N N 

XK_O Latin capital O O 

XK _P Latin capital P P 

XK_Q Latin capital Q Q 

XK_R Latin capital R R 

XK_S Latin capital S S 

XK_T Latin capital T T 

XK_U Latin capital U U 

XK_V Latin capital V Vv <a 
XK_W Latin capital W WwW are 
XK, X Latin capital X xX aoe 
XK_Y Latin capital Y Y S 
XK_Z Latin capital Z Z 

XK_bracketleft Left square bracket [ 

XK_backslash Reverse solidus \ 

XK_bracketright Right square bracket ] 

XK_asciicircum Circumflex accent % 

XK_underscore Low line 

XK_quoteleft Grave accent 

XK_a Latin small a a 

XK_b Latin small b b 

XK_c Latin small c C 

XK_d Latin small d d 

XK_e Latin small e e 

XK_f Latin small f f 

XK_g Latin small g g 

XK_h Latin small h h 

XK_i Latin small i i 
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Table H-3, LATIN1 (continued) 





XK_j 

XK_k 

XK_1 

XK_m 

XK_n 

XK_o 

XK_p 

XK_q 

XK_4& 

XK_s 

XK_t 

XK_u 

XK_v 

XK_w 

XK_x 

XK_y 

XK_Z 
XK_braceleft 
XK_bar 
XK_braceright 
XK_asciitilde 
XK_nobreakspace 
XK_exclamdown 
XK_cent 
XK_sterling 
XK_currency 
XK_yen 
XK_brokenbar 
XK_section 

XK diaeresis 
XK_copyright 
XK_ordfeminine 
XK_guillemotleft 
XK_notsign 
XK_hyphen 
XK_registered 
XK_macron 


XK_degree 
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Latin small j 

Latin small k 

Latin small 1 

Latin small m 

Latin small n 

Latin small o 

Latin small p 

Latin small q 

Latin small r 

Latin small s 

Latin small t 

Latin small u 

Latin small v 

Latin small w 

Latin small x 

Latin small y 

Latin small z 

Left brace 

Vertical line 

Right brace 

Tilde 

No-break space 

Inverted exclamation mark 
Cent sign 

Pound sign 

Currency sign 

Yen sign 

Broken vertical bar 
Paragraph sign, section sign 
Diaeresis 

Copyright sign 

Feminine ordinal indicator 
Left angle quotation mark 
Not sign 

Short horizontal hyphen 
Registered trade mark sign 
Macron 

Degree sign, ring above 


j 
k 
l 
m 
n 
0 
p 
q 
r 
s 
t 
u 
v 
w 
x 
ye 
zZ 
{ 
} 


> -- 1K O th ee - a 


» © 
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Table H-3. LATIN1 (continued) 





Character 
















XK_plusminus Plus-minus sign Es 
XK_twosuperior Superscript two é 
XK_threesuperior Superscript three : 
XK_acute Acute accent : 
XK_mu Micro sign WL 
XK_paragraph Pilcrow sign 1 
XK_periodcentered | Middle dot 

XK_cedilla Cedilla ; 
XK_onesuperior Superscript one : 
XK_masculine Masculine ordinal indicator 2 
XK_guillemotright | Right angle quotation mark » 
XK_onequarter Vulgar fraction one quarter Wa 
XK_onehalf Vulgar fraction one half 1/2 
XK_threequarters Vulgar fraction three quarters 3/4 






XK_questiondown Inverted question mark 














XK_Agrave Latin capital A with grave accent 

XK_Aacute Latin capital A with acute accent 

XK_Acircumflex Latin capital A with circumflex accent 

XK_Atilde Latin capital A with tilde a 
XK_Adiaeresis Latin capital A with diaeresis o 
XK Aring Latin capital A with ring above io 
XK_AE Latin capital diphthong AE o 
XK_Ccedilla Latin capital C with cedilla 

XK_Egrave Latin capital E with grave accent 

XK_Eacute Latin capital E with acute accent 






Latin capital E with circumflex accent 
Latin capital E with diaeresis 

Latin capital I with grave accent 
Latin capital I with acute accent 

Latin capital I with circumflex accent 
Latin capital I with diaeresis 


XK_Ecircumflex 






XK_ Ediaeresis 






XK_Igrave 
XK_Iacute 


XK_Icircumflex 








re ee i: > os BY De DD: Dr D> Di Dre 


XK_Idiaeresis 










XK_Eth Icelandic capital ETH 

XK_Ntilde Latin capital N with tilde N 

XK_Ograve Latin capital O with grave accent O 

XK_Oacute Latin capital O with acute accent 0 
- XK_Ocircumflex Latin capital O with circumflex accent 0 

XK_Otilde Latin capital O with tilde 0 

XK Odiaeresis Latin capital O with diaeresis O 
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Table H-3. LATIN1 (continued) 


XK_multiply 
XK_Ooblique 
XK_Ugrave 
XK_Uacute 
XK_Ucircumflex 
XK_Udiaeresis 
XK_Yacute 
XK_Thorn 
XK_ssharp 
XK_agrave 
XK_aacute 
XK_acircumflex 
XK_atilde 
XK_adiaeresis 
XK_aring 
XK_ae 
XK_ccedilla 
XK_egrave 
XK_eacute 
XK_ecircumflex 
XK_ediaeresis 
XK_igrave 
XK_iacute 
XK_icircumflex 
XK_idiaeresis 
XK_eth 
XK_ntilde 
XK_ograve 
XK_oacute 
XK_ocircumflex 
XK_otilde 
XK_odiaeresis 
XK_division 
XK_oslash 
XK_ugrave 
XK_uacute 
XK_ucircumflex 


XK_udiaeresis 
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Multiplication sign 

Latin capital O with oblique stroke 
Latin capital U with grave accent 
Latin capital U with acute accent 


Latin capital U with circumflex accent 


Latin capital U with diaeresis 

Latin capital Y with acute accent 
Icelandic capital THORN 

German small sharp s 

Latin small a with grave accent 
Latin small a with acute accent 
Latin small a with circumflex accent 
Latin small a with tilde 

Latin small a with diaeresis 

Latin small a with ring above 

Latin small diphthong ae 

Latin small c with cedilla 

Latin small e with grave accent 
Latin small e with acute accent 
Latin small e with circumflex accent 
Latin small e with diaeresis 

Latin small i with grave accent 
Latin small i with acute accent 
Latin small i with circumflex accent 
Latin small i with diaeresis 
Icelandic small eth 

Latin small n with tilde 

Latin small o with grave accent 
Latin small o with acute accent 
Latin small o with circumflex accent 
Latin small o with tilde 

Latin small o with diaeresis 
Division sign 

Latin small o with oblique stroke 
Latin small u with grave accent 
Latin small u with acute accent 
Latin small u with circumflex accent 
Latin small u with diaeresis 


Character 
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Table H-3. LATIN1 (continued) 


Keysym 


XK_yacute 
XK_ thorn 
XK_ydiaeresis 


Appendix H: Keysyms 


Description 
Latin small y with acute accent 


Icelandic small thorn 
Latin small y with diaeresis 





Character 
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a 
© 
— 
© 
a 
© 
=} 
io 
c 


TER Ue 





Table H-4. LATIN2 


Keysym 


XK_Aogonek 
XK_breve 
XK_Lstroke 
XK_Lcaron 
XK_Sacute 
XK_Scaron 
XK_Scedilla 
XK_Tcaron 
XK_Zacute 
XK_Zcaron 
XK_ Zabovedot 
XK_aogonek 
XK_ogonek 
XK_lstroke 
XK_lcaron 
XK_sacute 
XK_caron 
XK_scaron 
XK_scedilla 
XK_tcaron 
XK_zacute 
XK_doubleacute 
XK_zcaron 
XK_zabovedot 
XK_Racute 
XK_Abreve 
XK_Cacute 
XK_Ccaron 
XK_Eogonek 
XK_Ecaron 
XK_Dcaron 
XK_Nacute 

XK Ncaron 
XK_Odoubleacute 
XK_Rcearon 

XK Uring 
XK_Udoubleacute 
XK Tcedilla 
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Latin capital 
Breve 

Latin capital 
Latin capital 
Latin capital 
Latin capital 
Latin capital 
Latin capital 
Latin capital 
Latin capital 








A with ogonek 


L with stroke 

L with caron 

S with acute accent 
S with caron 

S with cedilla 

T with caron 


Z with acute accent 


Z with caron 


Latin capital Z with dot above 
Latin small a with ogonek 


Ogonek 


Latin small 1 with stroke 
Latin small 1 with caron 
Latin small s with acute accent 


Caron 


Latin small s with caron 

Latin small s with cedilla 
Latin small t with caron 

Latin small z with acute accent 
Double acute accent 

Latin small z with caron 

Latin small z with dot above 


Latin capital 
Latin capital 
Latin capital 
Latin capital 
Latin capital 
Latin capital 
Latin capital 
Latin capital 
Latin capital 


Latin capital O with double acute accent 


Latin capital 
Latin capital 
Latin capital 
Latin capital 


R with acute accent 
A with breve 

C with acute accent 
C with caron 

E with ogonek 

E with caron 

D with caron 

N with acute accent 
N with caron 


R with caron 
U with ring above 


U with double acute accent 


T with cedilla 


Character 
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Table H-4. LATIN2 (continued) 


Keysym 


XK_racute 
XK_abreve 
XK_cacute 
XK_ccaron 
XK_eogonek 
XK_ecaron 
XK_dcaron 
XK_nacute 
XK_ncaron 
XK_odoubleacute 
XK_rcaron 
XK_uring 
XK_udoubleacute 
XK_tcedilla 
XK_abovedot 
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Latin small r with acute accent 

Latin small a with breve 

Latin small c with acute accent 

Latin small c with caron 

Latin small e with ogonek 

Latin small e with caron 

Latin small d with caron 

Latin small n with acute accent 

Latin small n with caron 

Latin small o with double acute accent 
Latin small r with caron 

Latin small u with ring above 

Latin small u with double acute accent 
Latin small t with cedilla 

Dot above 





Character 


ae Fh 


as &« OM & Ov 


suet ER So mK OF Ek Eh 
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wx 
© 
ec) 
GS 
ae 
© 
= 
to 
a. 


TR 





Table H-5. LATIN3 


Keysym 


XK_Hstroke 
XK_Hcircumflex 
XK_Iabovedot 
XK_Gbreve 
XK_Jcircumflex 
XK_hstroke 
XK_hcircumflex 
XK_idotless 
XK_gbreve 
XK_jcircumflex 
XK_Cabovedot 
XK_Ccircumflex 
XK_Gabovedot 
XK_Gcircumflex 
XK_Ubreve 
XK_Scircumflex 
XK_cabovedot 
XK_ccircumflex 
XK_gabovedot 
XK_gcircumflex 
XK_ubreve 


XK_scircumflex 
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Description 


Latin capital H with stroke 

Latin capital H with circumflex accent 
Latin capital I with dot above 

Latin capital G with breve 

Latin capital J with circumflex accent 
Latin small h with stroke 

Latin small h with circumflex accent 
Small dotless i 

Latin small g with breve 

Latin small j with circumflex accent 
Latin capital C with dot above 

Latin capital C with circumflex accent 
Latin capital G with dot above 

Latin capital G with circumflex accent 
Latin capital U with breve 

Latin capital S with circumflex accent 
Latin small c with dot above 

Latin small c with circumflex accent 
Latin small g with dot above 

Latin small g with circumflex accent 
Latin small u with breve 

Latin small s with circumflex accent 
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Table H-6. LATIN4 





XK_kappa Latin small kappa 

XK_Rcedilla | Latincapital R with cedilla R 

XK Itilde Latin capital I with tilde I 

XK_Lcedilla | Latincapital L with cedilla L 

XK_Emacron Latin capital E with macron E 

XK Gcedilla | Latincapital G with cedilla G 

XK_Tslash Latin capital T with oblique stroke 

XK_rcedilla | Latin small r with cedilla T 

XK _itilde Latin small i with tilde i 

XK_lcedilla | Latin small 1 with cedilla | 

XK_emacron Latin small e with macron € 

XK_gacute Latin small g with acute accent g 

XK_tslash Latin small t with oblique stroke 

XK_ENG | Lappish capital ENG 

XK_eng Lappish small eng 

XK_Amacron Latin capital A with macron A 

XK_Iogonek Latin capital I with ogonek ] 

XK_Eabovedot | Latin capital E with dot above E 

XK_Imacron Latin capital I with macron I rs 
XK Ncedilla | Latin capital N with cedilla 0 > 
XK_Omacron Latin capital O with macron O Ss = 
XK Kcedilla | Latin capital K with cedilla K e 
XK_Uogonek Latin capital U with ogonek U 

XK Utilde Latin capital U with tilde U 

XK_Umacron Latin capital U with macron U 

XK_amacron Latin small a with macron a 

XK_iogonek Latin small i with ogonek i 

XK_eabovedot | Latin small e with dot above é 

XK_imacron Latin small i with macron I 

XK_ncedilla Latin small n with cedilla n 

XK_omacron Latin small o with macron 3 

XK_kcedilla Latin small k with cedilla k 

XK_uogonek Latin small u with ogonek u 

XK _utilde Latin small u with tilde i 

XK_umacron Latin small u with macron i 
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Table H-7. GREEK 





Keysym 

XK_Greek_ALPHAaccent Greek capital alpha with accent 
XK_Greek_EPSILONaccent Greek capital epsilon with accent 

XK_Greek ETAaccent Greek capital eta with accent 
XK_Greek_IOTAaccent Greek capital iota with accent 
XK_Greek_IOTAdiaeresis Greek capital iota with diaeresis 

XK_ Greek _IOTAaccentdiaeresis Greek capital iota with accent+dieresis 
XK_Greek_OMICRONaccent Greek capital omicron with accent 
XK_Greek_UPSILONaccent ‘ Greek capital upsilon with accent 
XK_Greek_UPSILONdieresis Greek capital upsilon with dieresis 
XK_Greek_UPSILONaccentdieresis | Greek capital upsilon with accent+dieresis 
XK_Greek OMEGAaccent Greek capital omega with accent 
XK_Greek_alphaaccent Greek small alpha with accent 
XK_Greek_epsilonaccent Greek small epsilon with accent 
XK_Greek_etaaccent Greek small eta with accent 
XK_Greek_iotaaccent Greek small iota with accent 

XK_Greek iotadieresis Greek small iota with dieresis 

XK_Greek_ iotaaccentdieresis Greek small iota with accent+dieresis 
XK_Greek_omicronaccent Greek small omicron with accent 
XK_Greek_upsilonaccent Greek small upsilon with accent 
XK_Greek_upsilondieresis Greek small upsilon with dieresis 
XK_Greek_upsilonaccentdieresis | Greek small upsilon with accent+dieresis 
XK_Greek_omegaaccent Greek small omega with accent 

XK_Greek_ALPHA Greek capital alpha A 
XK_Greek_ BETA Greek capital beta B 
XK_Greek_GAMMA Greek capital gamma t 
XK_Greek_DELTA Greek capital delta A 
XK_Greek EPSILON Greek capital epsilon E 
XK_Greek_ZETA Greek capital zeta Z 
XK_Greek ETA Greek capital eta H 
XK_Greek_ THETA Greek capital theta e 
XK_Greek_IOTA Greek capital iota I 
XK_Greek_ KAPPA Greek capital kappa K 
XK_Greek_LAMBDA Greek capital lambda A 
XK_Greek_MU Greek capital mu M 
XK_Greek_NU Greek capital nu N 
XK_Greek_XI Greek capital xi = 
XK_Greek_OMICRON Greek capital omicron O 
XK_Greek PI Greek capital pi Tl 
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Table H-7. GREEK (continued) 


Keysym 


XK_Greek_RHO 
XK_Greek_SIGMA 
XK_Greek_TAU 
XK_Greek_UPSILON 
XK_Greek PHI 
XK_Greek_ CHI 

XK_ Greek PSI 
XK_Greek_ OMEGA 
XK_Greek_alpha 
XK_Greek beta 
XK_Greek_ gamma 
XK_Greek delta 
XK_Greek_epsilon 
XK_Greek_zeta 
XK_Greek_eta 
XK_Greek_theta 
XK_Greek_ iota 
XK_Greek_kappa 
XK_Greek_ lambda 
XK_Greek_mu 
XK_Greek_ nu 
XK_Greek_xi 
XK_Greek_omicron 
XK_Greek_pi 
XK_Greek_rho 
XK_Greek_sigma 
XK_Greek_finalsmallsigma 
XK_ Greek tau 
XK_Greek_upsilon 
XK_Greek_phi 
XK_Greek_chi 

XK_ Greek _ psi 
XK_Greek_omega 


XK_Greek_switch 


Appendix H: Keysyms 


Description 


Greek capital tho 
Greek capital sigma 
Greek capital tau 
Greek capital upsilon 
Greek capital phi 
Greek capital chi 
Greek capital psi 
Greek capital omega 
Greek smali alpha 
Greek small beta 
Greek small gamma 
Greek small delta 
Greek small epsilon 
Greek small zeta 
Greek small eta 
Greek small theta 
Greek small iota 
Greek small kappa 
Greek small lambda 
Greek small mu 
Greek small nu 
Greek small xi 
Greek small omicron 
Greek small pi 
Greek small rho 
Greek small sigma 
Greek small final small sigma 
Greek small tau 
Greek small upsilon 
Greek small phi 
Greek small chi 
Greek small psi 
Greek small omega 
Switch to Greek set 


Character 
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The Cursor Font 


A standard font consisting of a number of cursor shapes is available. This font is loaded 
automatically when XCreateFontCursor, the routine used to create a standard cursor, is 
called. To specify a cursor shape from the standard font, use one of the symbols defined in 
the file <X11/cursorfont.h>, by including it in your source code. The symbols for the avail- 
able cursors and an illustration of their shapes is provided here. The technique used for 
creating a cursor is described in Volume One, Section 6.6. 


You may notice that the symbol values skip the odd numbers; there are really two font char- 
acters for each shape but we are only showing you one. Each odd-numbered character (not 
shown) is a mask that selects which pixels in the screen around the cursor are modified. 


The standard cursor shapes are shown in Figure I-1. The mask shapes have been removed. 
Each row in Figure I-1 contains twelve cursor shapes (except the last one). Table I-1 shows 
the symbol definitions from <X1J1/cursorfont.h> grouped by rows corresponding to the rows 
in Figure I-1. 





: Figure I-1. The Standard Cursors 
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Table I-1. Standard Cursor Symbols 


Symbol 

Row 1 
XC_X cursor 
XC_arrow 


XC_based_arrow_down 
XC_based_arrow_up 
XC_boat 

XC_bogosity 
XC_bottom_left_ corner 
XC_bottom_right corner 
XC_bottom_side 
XC_bottom_tee 

XC_box spiral 
XC_center ptr 


Row 2 
XC ¥cizele 
XC_clock 
XC_coffee_mug 
XC_cross 
XC_cross_ reverse 
XC_crosshair 
XC_diamond_cross 
XC_dot 
XC_dotbox 
XC_double arrow 
XC_draft_large 
XC_draft small 


Row 3 
XC_draped_ box 
XC_exchange 
XC_fleur 
XC_gobbler 
XC_gumby 
XC_hand1 
XC_hand2 
XC_heart 
XC_icon 
XC_iron_cross 
XC left ptr 
XC_left side 
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Value 





Row 4 
XCTlert tee 
XC_left_button 
XC_11_ angle 
XC_lr angle 
XC_man 
XC_middlebutton 
XC_mouse 
XC_pencil 
XC_pirate 
XC_plus 
XC_question arrow 
XC_right_ ptr 


Row 5 
XC_right_side 
XC_right_tee 
XC_rightbutton 
XC_rtl_ logo 
XC_sailboat 
XC_sb_down_arrow 
XC_sb_h double arrow 
XC_sb_ left arrow 
XC_sb_ right arrow 
XC_sb_up arrow 
XC_sb_ v_double arrow 
XC_shuttle 


Row 6 
XC_sizing 
XC_spider 
XC_spraycan 
XC_star 
XC_target 
XC_tcross 
XC_top_left_arrow 
XC_top_ left corner 
XC_top_ right corner 
XC_top_side 
XC_top tee 
XC_trek 


Row 7 
XC_ul_angle 
XC_umbrella 
XC_ur_angle 
XC_watch 
XC_xterm 
XC_num_glyphs 
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98 
100 
102 
104 
106 
108 
110 
112 
114 
116 
118 


120 
122 
124 
126 
128 
130 
132 
134 
136 
138 
140 
142 


144 
146 
148 
150 
152 
154 


J 
The Xmu Library 


The Xmu Library is a collection of miscellaneous utility functions that have been useful in 
building various applications and Xt toolkit widgets. Though not defined by any X consor- 
tium standard, this library is written and supported by MIT in the core distribution, and there- 
fore should be available on virtually all machines. 


This appendix presents reference pages for each Xmu function available in R4. For a sum- 
mary of the contents of Xmu, see Volume One, Appendix H, The Xmu Library. For a list of 
which functions are available in R3, see Volume One, Appendix G, Release Notes. At cach 
release the number and variety of functions in this library has increased dramatically. It is 
worthwhile skimming this appendix to see what is available in R4, even if you are familiar 
with the R3 Xmu library. 


Each group of Xmu functions designed around a particular task has its own header file, listed 
in the Synopsis section of each reference page. Note that the location of the header files of 
Xmu has changed in R4. In R3 and earlier, the header files for all X libraries were stored in 
/usrlinclude/X11. In R4, the header files for Xmu and Xaw are located in subdirectories of 
this directory, named after each library. In other words, the Xmu header files are now located 
(by default, on UNIX-based systems) in /usr/include/X11/Xmu. 
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XctCreate Xmu — Compound Text Functions— 


Name 
XctCreate — create a XctData structure for parsing a Compound Text string. 


Synopsis 


#include <X11/Xmu/Xct .h> 
XctData XctCreate(string, length, flags) 


XctString string; 
int length; 
XctFlags flags; 


Arguments 
string Specifies the Compound Text string. 
length Specifies the number of bytes in st ring. 
flags Specifies parsing control flags. 
Description 
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XctCreate creates an XctData structure for parsing a Compound Text string. The string 
need not be null terminated. The following flags are defined to control parsing of the string: 


XctSingleSetSegments 


This means that returned segments should contain characters from only one set (CO, Cl, 
GL, GR). When this is requested, Xct Segment is never returned by XctNext Item, 
instead Xct COSegment, XctClSegment, XctGlSegment, and XctGRSegment are 
returned. CO and C1 segments are always returned as singleton characters. 


XctProvideExtensions 


This means that if the Compound Text string is from a higher version than this code is 
implemented to, then syntactically correct but unknown control sequences should be 
returned as XctExtension items by XctNextItem. If this flag is not set, and the 
Compound Text string version indicates that extensions cannot be ignored, then each 
unknown control sequence will be reported as an XctError. 


XctAcceptCOExtensions 


This means that if the Compound Text string is from a higher version than this code is 
implemented to, then unknown CO characters should be treated as if they were legal, and 
returned as CO characters (regardless of how Xct ProvideExtensions is set) by Xct- 
Next Item. If this flag is not set, then all unknown CO characters are treated according to 
XctProvideExtensions, 


XctAcceptClExtensions 


This means that if the Compound Text string is from a higher version than this code is 
implemented to, then unknown C1 characters should be treated as if they were legal, and 
returned as C1 characters (regardless of how Xct ProvideExtensions is set) by Xct- 
Next Item. If this flag is not set, then all unknown C1 characters are treated according to 
XctProvideExtensions. 
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Xmu — Compound Text Functions (continued) XctCreate 


XctHideDirection ‘ 
This means that horizontal direction changes should be reported as XctHorizontal 
items by XctNext Item. If this flag is not set, then direction changes are not returned as 
items, but the current direction is still maintained and reported for other items. The current 
direction is given as an enumeration, with the values XctUnspecified, XctLeft- 
ToRight, and XctRightToLeft. 


XctFreeString 
This means that Xct Free should free the Compound Text string that is passed to Xct - 
Create. If this flag is not set, the string is not freed. 


Xct ShiftMultiGRToGL 
This means that XctNext Item should translate GR segments on-the-fly into GL seg- 
ments for the GR sets: GB2312.1980-1, JISK0208.1983-1, and KSC5601.1987-1. 


_ Related Commands 
XctF ree, XctNextItem, XctReset. 
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XctFree Xmu — Compound Text Functions — 


Name 
XctFree — free an XctData structure. 


Synopsis 
#include <X11/Xmu/Xct.h> 
void XctFree (data) 
XctData data; 


Arguments 
data Specifies the Compound Text structure. 


Description 


XctF ree frees all data associated with the XctData structure. 


Related Commands 
XctNextiItem, XctReset. 
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— Xmu — Compound Text Functions XctNextltem 


Name 
XctNextItem — parse the next item in a Compound Text string. 


Synopsis 
#include <X11/Xmu/xXct.h> 
XctResult XctNextItem(data) 
XctData data; 


Arguments 
data Specifies the Compound Text structure. 


Description 
XctNext Item parses the next item in the Compound Text string. The return value indicates 
what kind of item is returned. The item itself, it’s length, and the current contextual state, are 
reported as components of the XctData structure. Xct Result is an enumeration, with the 
- following values: 


XctSegment 
The item contains some mixture of CO, GL, GR, and C1 characters. 


XctC0Segment 
The item contains only CO characters. 


XctGLsSegment 
The item contains only GL characters. 


XctClSegment 
the item contains only C1 characters. 


XctGRSegment 
the item contains only GR characters. 


XctExtendedSegment 
The item contains an extended segment. 


XctExtension 
The item is an unknown extension control sequence. 


XctHorizontal 
The item indicates a change in horizontal direction or depth. The new direction and depth 
are recorded in the XctData Structure. 


XctEndoOfText 
The end of the Compound Text string has been reached. 


XctError 
The string contains a syntactic or semantic error; no further parsing should be performed. 


Structures Ss 
typedef struct { = 
XctString item; __/* the action item */ s 

= 
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XctNextitem 


Tote emmeLencit hy 
int char size; 


char *encoding; 
XctHDirection horizontal; 
imt horz depth, 

char *GL; 

char *GL encoding; 
int Gh set size; 

imi GL char size; 
char *GRi 

char *GR_encoding; 
imit GR set sizes. 
int GR_char_ size; 
char *GLGR_ encoding; 


} XctData; 


Related Commands 
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XctCreate, XctFree, XctReset. 


(continued) 


/* 
/* 

* 
/* 
/* 
/* 
/* 
/* 
/* 
/* 
/* 
px 
/* 
/* 
/* 


* 
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the length of item in bytes */ 
the number of bytes per character in 
item, with zero meaning variable */ 


the 
the 
the 
the 
the 


XLFD encoding name for 
direction of item */ 


item */ 


current direction nesting depth */ 


Uo} Sr erg fovemtine 
XLFD encoding name for 


Gan or 9G / 


the 
the 
the 


number of bytes per GL 
Cine stiraing, for the 
XLFD encoding name the 


94 or 96 */ 


the 
the 


number of bytes per GR 
XLFD encoding name for 


GL+GR, if known */ 


current GL */ 
the current € 


character */ 
current GR */ 
for current ¢ 


character */ 
the current 
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— Xmu — Compound Text Functions— XctReset 


Name 
XctReset — reset an XctData structure for reparsing a Compound Text string. 


Synopsis 
#include <X11/Xmu/Xct.h> 
void XctReset (data) 
XctData data; 


Arguments - 
data Specifies the Compound Text structure. 

Description 
XctReset resets the Xct Data Structure to reparse the Compound Text string from the begin- 
ning. 


Related Commands 
XctCreate, XctFree, XctNextItem. 
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XmuAddCloseDisplayHook \ Kerala tan Gilen Naar 


Name 
XmuAddCloseDisplayHook — add callback function to be called when display connection is 
closed. 
Synopsis 


#include <X11/Xmu/CloseHook.h> 

CloseHook XmuAddCloseDisplayHook (display, func, arg) 
Display *display; 
ant (* func) ().7 
‘Caddr t arg; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
func Specifies the function to call at display close. 
arg Specifies arbitrary data to pass to func. 

Description 


XmuAddCloseDisplayHook registers a callback for the given display. When the display is 
closed, the given function will be called with the given display and argument as: 


(*func) (display, arg) 


The function is declared to return int even though the value is ignored, because some com- 
pilers have problems with functions returning void. 


This routine returns NULL if it was unable to add the callback, otherwise it returns an opaque 
handle that can be used to remove or lookup the callback. 


Related Commands 


XmuAddCloseDisplayHook, XmuLookupCloseDisplayHook, XmuRemoveClose- 
DisplayHook. 
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yeni Standard Coldtinaps ) XmuAllStandardColormaps 


Name 
XmuAllStandardColormaps — create all supported standard colormaps and set standard color- 
map properties. 
Synopsis 


#include <X11/Xmu/StdCmap.h> 
Status XmuAllStandardColormaps (display) 
Display *display; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 


Description 
XmuAllStandardColormaps creates all of the appropriate standard colormaps for every 
visual of every screen on a given display. 


XmuAl1StandardColormaps defines and retains as permanent resources all these standard 
colormaps. It returns zero on failure, non-zero on success. If the property of any standard 
colormap is already defined, this function will redefine it. 


This function is intended to be used by window managers or a special client at the start of a ses- 
sion. 


The standard colormaps of a screen are defined by properties associated with the screen’s root 
window. The property names of standard colormaps are predefined, and each property name 
except RGB_DEFAULT MAP may describe at most one colormap. 


The standard colormaps are: RGB BEST MAP, RGB RED MAP, RGB GREEN MAP, 
RGB _BLUE_MAP, RGB DEFAULT MAP, and RGB_GRAY MAP. Therefore a screen may have at 
most 6 standard colormap properties defined. 


A standard colormap is associated with a particular visual of the screen. A screen may have 
multiple visuals defined, including visuals of the same class at different depths. Note that a 
visual ID might be repeated for more than one depth, so the visual ID and the depth of a visual 
identify the visual. The characteristics of the visual will determine which standard colormaps 
are meaningful under that visual, and will determine how the standard colormap is defined. 
Because a standard colormap is associated with a specific visual, there must be a method of 
determining which visuals take precedence in defining standard colormaps. 


The method used here is: for the visual of greatest depth, define all standard colormaps mean- 
ingful to that visual class, according to this order of (descending) precedence: DirectColor; 
PseudoColor; TrueColor; and GrayScale; and finally StaticColor and Static- 
Gray. 


This function allows success on a per screen basis. For example, if a map on screen 1 fails, the 
maps on screen 0, created earlier, will remain. However, none on screen 1 will remain. If a 
map on screen 0 fails, none will remain. 
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XmuAllStandardColormaps (continued) Xmu — Standard Colormaps 


Related Commands 
XmuCreateColormap, XmuDeleteStandardColormap, XmuGetColormap-— 
Allocation, XmuLookupStdCmp, XmuStandardColormap, XmuVisualStandard- 
Colormaps. 
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— Xmu — Window Utility Functions — XmuClientWindow 


Name 
XmuClientWindow — find a window which has a WM_ STATE property. 


Synopsis 
#include <X11/Xmu/WinUtil.h> 
Window XmuClientWindow (display, win) 
Display *display; 
Window win; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
win Specifies the window. 

Description 


XmuClientWindow finds a window, at or below the specified window, which has a 


WM STATE property. If such a window is found, it is returned, otherwise the argument window 
is returned. 


Related Commands 
XmuScreenOfWindow, XmuUpdateMapHints. 
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XmuComparelSOLatint1 Xmu — Character Set Functions— 


Name 
XmuCompareISOLatin1 — compare and determine order of two strings, ignoring case. 


Synopsis 
#include <X11/Xmu/CharSet.h> 
int XmuCompareISOLatinl(first, second) 
char *first, *second; 


Arguments 
first Specifies a string to compare. 
second Specifies a string to compare. 


Description 
XmuCompareISOLatin1 compares two NULL terminated Latin-1 strings, ignoring case dif- 
ferences, and returns an integer greater than, equal to, or less than zero, according to whether 
first is lexicographically greater than, equal to, or less than second. The two strings are 
assumed to be encoded using ISO 8859-1 (Latin-1). 


Related Commands 
XmuCopyISOLatinlLowered, XmuCopyISOLatinlUppered, XmuLookup. 
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——Xmu — Character Set Functions XmuCopylSO Latin1 Lowe red 


Name : 
XmuCopyISOLatinlLowered — copy string, changing upper case to lower case. 


Synopsis 
#include <X11/Xmu/CharSet.h> 
void XmuCopyISOLatinlLowered(dst, src) 
Char *dst,; “src; 


Arguments 
dst Returns the string copy. 
Src Specifies the string to copy. 
Description 


xmuCopyISOLat in1lLowered copies a null terminated string from src to dst (including 
the NULL), changing all Latin-1 upper-case letters to lower-case. The string is assumed to be 
encoded using ISO 8859-1 (Latin-1). 


Related Commands 
XmuCompareISOLatin1l, XmuCopyISOLatinlUppered, XmuLookup. 
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XmuCopylSOLatin1 Uppered Xmu — Character Set Functions— 


Name 
XmuCopy!ISOLatin1 Uppered — copy string, changing lower case to upper case. 


Synopsis 
#include <X11/Xmu/CharSet .h> 
void XmuCopyISOLatinlUppered(dst, src) 
char *dst, *src; 


Arguments 
dst Returns the string copy. 
sre Specifies the string to copy. 


Description 
XmuCopyISOLatinlUppered copies a null terminated string from src to dst (including 
the NULL), changing all Latin-1 lower-case letters to upper-case. The string is assumed to be 
encoded using ISO 8859-1 (Latin-1). 


Related Commands 
XmuCompareISOLatini1, XmuCopyISOLatinlLowered, XmuLookup. 
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— Xmu — Standard Colormaps XmuCreateColormap 


Name 
XmuCreateColormap — create a standard colormap from information in an XStandard- 
Colormap structure. 


Synopsis 
#include <X11/Xmu/StdCmap.h> 
Status XmuCreateColormap (display, colormap) 
Display *display; 
XStandardColormap *colormap; 


Arguments 
display Specifies the connection under which the map is created. 


colormap Specifies the map to be created. 


Description 
XmuCreateColormap creates any one colormap which is described by an XStandard- 
Colormap Structure. 


XmuCreateColormap returns zero on failure, and non-zero on success. The base_pixel 
field of the XStandardColormap structure is set on success. Resources created by this 
function are not made permanent. No argument error checking is provided; use at your own 
risk. 

All colormaps are created with read-only allocations, with the exception of read-only alloca- 
tions of colors which fail to return the expected pixel value, and these are individually defined 
as read/write allocations. This is done so that all the cells defined in the colormap are contigu- 
ous, for use in image processing. This typically happens with White and Black in the default 
map. 


Colormaps of static visuals are considered to be successfully created if the map of the static 
visual matches the definition given in the standard colormap structure. 


Related Commands 


XmuAllStandardColormaps, XmuDeleteStandardColormap, XmuGet — 
ColormapAllocation, XmuLookupStdCmp, XmuStandardColormap, XmuVisual- 
StandardColormaps. 
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Name 
XmucCreatePixmapFromBitmap — create multi-plane pixmap and copy data from one-plane 
pixmap. 
Synopsis 


#include <X11/Xmu/Drawing.h> 
Pixmap XmuCreatePixmapFromBitmap (display, d, bitmap, width, 
height, depth, fore, back) 
Display *display; 
Drawable d; 
Pixmap bitmap; 
unsigned int width, height; 
unsigned int depth; 
unsigned long fore, back; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
d Specifies the screen the pixmap is created on. 
bitmap Specifies the bitmap source. 
width Specifies the width of the pixmap. 
height Specifies the height of the pixmap. 
depth Specifies the depth of the pixmap. 
fore Specifies the foreground pixel value. 
back Specifies the background pixel value. 
Description 


XmuCreatePixmapFromBitmap creates a pixmap of the specified width, height, and depth, 
on the same screen as the specified drawable, and then performs an XCopyPlane from the 
specified bitmap to the pixmap, using the specified foreground and background pixel values. 
The created pixmap is returned. The original bitmap is not destroyed. 


Related Commands 
XmuCreateStippledPixmap, XmuDrawLogo, XmuDrawRoundedRectangle, Xmu- 
FillRoundedRectangle, XmuLocateBitmapFile, XmuReadBitmapData, Xmu- 
ReadBitmapDataFromFile, XmuReleaseStippledPixmap. 
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= inl = Ghaphice Pundtions J XmuCreateStippledPixmap 


Name 
XmuCreateStippledPixmap — create two pixel by two pixel gray pixmap. 


Synopsis 
#include <X11/Xmu/Drawing.h> 
Pixmap XmuCreateStippledPixmap (screen, fore, back, depth) 
Screen *screen; 
Pixel fore, back; 
unsigned int depth; 


Arguments 
screen Specifies the screen the pixmap is created on. 
fore Specifies the foreground pixel value. 
back Specifies the background pixel value. 
depth Specifies the depth of the pixmap. 
Description 


XmuCreateSt ippledPixmap creates a two pixel by two pixel stippled pixmap of specified 
depth on the specified screen. The pixmap is cached so that multiple requests share the same 
pixmap. The pixmap should be freed with XnuReleaseStippledPixmap to maintain cor- 
rect reference counts. 


Related Commands 
XmuCreatePixmapFromBitmap, XmuDrawLogo, XmuDrawRoundedRectangle, 
XmuFillRoundedRectangle, XmuLocateBitmapFile, XmuReadBitmapData, 
XmuReadBitmapDataFromFile, XmuReleaseStippledPixmap. 
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XmuCursorNameToindex \“—— Xmu - Cursor Utility Functions— 


Name 
XmuCursorNameToIndex — return index in cursor font given string name. 


Synopsis 
#include <X11/Xmu/CurUtil.h> 
int XmuCursorNameToIndex (name) 
char *name; 


Arguments 
name Specifies the name of the cursor. 


Description 
XmuCursorNameToIndex takes the name of a standard cursor and returns its index in the 
standard cursor font. The cursor names are formed by removing the XC__ prefix from the cur- 
sor defines listed in Appendix I, The Cursor Font. 
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— Xmu — Display Queue Functions —— XmuDQAddDisplay 


Name , 
XmuDQAddDisplay — add a display connection to a display queue. 


Synopsis 
#include <X11/Xmu/DisplayQue.h> 
XmuDisplayQueueEntry *XmuDQAddDisplay(q, display, data) 
XmuDisplayQueue *q; 
Display *display; 
caddr_ t data; 


Arguments 

q Specifies the queue. 

display Specifies the display connection to add. 

data Specifies private data for the free callback function. 
Description 


XmuDQAddDisplay adds the specified display to the queue. If successful, the queue entry is 
returned, otherwise NULL is returned. The data value is simply stored in the queue entry for use 
by the queue’s free callback. This function does not attempt to prevent duplicate entries in the 
queue; the caller should use XmuDQLookupDisplay to determine if a display has already 
been added to a queue. 


Related Commands 


XmuDQCreate, XmuDQDestroy, XmuDQLookupDisplay, XmuDQNDisplays, Xmu- 
DQRemoveDisplay. 
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XmuDQCreate \— Xmu - Display Queue Functions — 


Name 
XmuDQCreate — creates an empty display queue. 


Synopsis 
#include <X11/Xmu/DisplayQue.h> 
XmuDisplayQueue *XmuDQCreate(closefunc, freefunc, data) 
int (*closefunc) (); 
int (*freefunc) (); 
caddr_t data; 


Arguments 
closefunc _ Specifies the close function. 


freefunc Specifies the free function. 
data Specifies private data for the functions. 


Description 
XmuDQCreate creates and returns an empty XmuDisplayQueue (which is really just a set 
of displays, but is called a queue for historical reasons). The queue is initially empty, but dis- 
plays can be added using XmuAddDisplay. The data value is simply stored in the queue for 
use by the display close and free callbacks. Whenever a display in the queue is closed using 
XCloseDisplay, the display close callback (if non-NULL) is called with the queue and the 
display’s XmuDisplayQueueEnt ry as follows: 


(*closefunc) (queue, entry) 


The free callback (if non-NULL) is called whenever the last display in the queue is closed, as 
follows: 


(*freefunc) (queue) 
The application is responsible for actually freeing the queue, by calling XmuDQDest roy. 
Related Commands 


XmuDQAddDisplay, XmuDQDestroy, XmuDQLookupDisplay, XmuDQNDisplays, 
XmuDQRemoveDisplay. 
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— Xmu — Display Queue Functions XmuDQDestroy 


Name . 
XmuDQDestroy — destroy a display queue, and optionally call callbacks. 


Synopsis 
#include <X11/Xmu/DisplayQue.h> 
Bool XmuDQDestroy(q, docallbacks) 
XmuDisplayQueue *q; 
Bool docallbacks; 


Arguments 
q Specifies the queue to destroy. 


docallbacks Specifies whether the close callback functions should be called. 


Description 
XmuDQDest roy releases all memory associated with the specified queue. If docallbacks 
is True, then the queue’s close callback (if non-NULL) is first called for each display in the 
queue, even though XCloseDisp1lay is not called on the display. 


Related Commands 


XmuDQAddDisplay, XmuDQCreate, XmuDQLookupDisplay, XmuDQNDisplays, 
XmuDQRemoveDisplay. 
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XmuDQLookupDisplay Xmu — Display Queue Functions— 


Name 
XmuDQLookupDisplay — determine display queue entry for specified display connection. 


Synopsis 
#include <X11/Xmu/DisplayQue.h> 
XmuDisplayQueueEntry *XmuDQLookupDisplay(q, display) 
XmuDisplayQueue *q; 
Display *display; 


Arguments 

q Specifies the queue. 

display Specifies the display to lookup. 
Description 


XmuDQLookupDisplay returns the queue entry for the specified display, or NULL if the dis- 
play is not in the queue. 


Related Commands 


XmuDQAddDisplay, XmuDQCreate, XmuDQDestroy, XmuDQNDisplays, Xmu- 
DQRemoveDisplay. 
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— Xmu — Display Queue Functions—— XmuDQNDisplays 


Name 
XmuDQNDisplays — return the nurtiber of display connections in a display queue. 


Synopsis 
#include <X11/Xmu/DisplayQue.h> 
XmuDQNDisplays (q) 


Description 
XmuDQNDisplays returns the number of displays in the specified queue. 


Related Commands 


XmuDQAddDisplay, XmuDQCreate, xmuDQDest roy, XmuDQLookupDisplay, Xma- 
DQRemoveDisplay. 
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XmuDQRemoveDisplay Xmu — Display Queue Functions— 


Name 
XmuDQRemoveDisplay — remove a display connection from a display queue. 


Synopsis 
#include <X11/Xmu/DisplayQue.h> 
Bool XmuDQRemoveDisplay(q, display) 
XmuDisplayQueue *q; 
Display *display; 


Arguments 

gq Specifies the queue. 

display Specifies the display to remove. 
Description 


XmuDQNDisplays removes the specified display connection from the specified queue. No 
callbacks are performed. If the display is not found in the queue, False is returned, otherwise 
True is returned. 


Related Commands 


XmuDQAddDisplay, XmuDQCreate, XmuDQDestroy, XmuDQLookupDisplay, Xmu- 
DQNDisplays. 
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==yfair sien dai Gowns XmuDeleteStandardColormap 


Name } 
XmuDeleteStandardColormap — remove any standard colormap property. 


Synopsis 
void XmuDeleteStandardColormap (display, screen, property) 
Display *display; 
int screen; 
Atom property; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
screen Specifies the screen of the display. 


property Specifies the standard colormap property. 


Description 
XmuDeleteStandardColormap will remove the specified property from the specified 
screen, releasing any resources used by the colormap(s) of the property, if possible. 


Related Commands 


XmuAl1lStandardColormaps, XmuCreateColormap, XmuGetColormap- 
Allocation, XmuLookupStdCmp, XmuStandardColormap, XmuVisualStandard- 
Colormaps. 
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XmuDrawLogo Xmu — Graphics Functions— 


Name 
XmuDrawLogo — draws the standard X logo. 


Synopsis 
#include <X11/Xmu/Drawing.h> 
XmuDrawLogo (display, drawable, gcFore, gcBack, x, y, width, 
height) 

Display *display; 
Drawable drawable; 
GC gcFore, gcBack; 
mnt ex, "yr 
unsigned int width, height; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 


drawable Specifies the drawable. 


gcFore Specifies the foreground GC. 

gcBack Specifies the background GC. 

x Specifies the upper left x coordinate. 

y Specifies the upper left y coordinate. 

width Specifies the logo width. 

height Specifies the logo height. 
Description 


XmuDrawLogo draws the ‘‘official’’ X Window System logo. The bounding box of the logo 
in the drawable is given by x, y, width, and height . The logo itself is filled using gcFore, 
and the rest of the rectangle is filled using gcBack. 


Related Commands 
XmuCreatePixmapFromBitmap, XmuCreateStippledPixmap, XmuD raw- 
RoundedRectangle, XmuFillRoundedRectangle, XmuLocateBitmapFile, Xmu- 
ReadBitmapData, XmuReadBitmapDataFromFile, XmuReleaseStippled- 
Pixmap. 
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=eadPerg nies palates ) XmuDrawRoundedRectangle 


Name ; 
XmuDrawRoundedRectangle — draws a rectangle with rounded corners. 


Synopsis 
#include <X11/Xmu/Drawing.h> 
void XmuDrawRoundedRectangle (display, draw, gc, X, Yy, WwW, h, ew, 
eh) 

Display *display; 
Drawable draw; 
GCrgc; 
int x, y, w, h, ew, eh; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
draw Specifies the drawable. 
gc Specifies the GC. 
x. Specifies the upper left x coordinate. 
Specifies the upper left y coordinate. 
w Specifies the rectangle width. 
h Specifies the rectangle height. 
ew Specifies the corner width. 
eh Specifies the corner height. 
Description 


XmuD rawRoundedRectangle draws a rounded rectangle, where x, y, w, h are the dimen- 
sions of the overall rectangle, and ew and eh are the sizes of a bounding box that the corners 
are drawn inside of; ew should be no more than half of w, and eh should be no more than half 
of h. The current GC line attributes control all attributes of the line. 


Related Commands 
XmuCreatePixmapFromBitmap, XmuCreateStippledPixmap, XmuDrawLogo, 
XmuFillRoundedRectangle, XmuLocateBitmapFile, XmuReadBitmapData, 
XmuReadBitmapDataFromFile, XmuReleaseStippledPixmap. 
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XmuFillRoundedRectangle \ ei Seeiahied PUneAoT a= 


Name 
XmuFillRoundedRectangle — fill a rectangle with rounded corners. 


Synopsis 
#include <X11/Xmu/Drawing.h> 
void XmuFillRoundedRectangle (display, draw, gc, X, Y, W, h, ew, 
eh) 

Display *display; 
Drawable draw; 
GC gc; 
ait ex, Uv, Ww, hb; ew, eh; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
draw Specifies the drawable. . 
gc Specifies the GC. 
x Specifies the upper left x coordinate. 
Specifies the upper left y coordinate. 
w Specifies the rectangle width. 
h Specifies the rectangle height. 
ew Specifies the corner width. 
eh Specifies the corner height. 
Description 


XmuFillRoundedRectangle draws a filled rounded rectangle, where x, y, w, h are the 
dimensions of the overall rectangle, and ew and eh are the sizes of a bounding box that the cor- 
ners are drawn inside of; ew should be no more than half of w, and eh should be no more than 
half of h. The current GC fill settings control all attributes of the fill contents. 


Related Commands 
XmuCreatePixmapFromBitmap, XmuCreateStippledPixmap, XmuDrawLogo, 
XmuDrawRoundedRectangle, XmuLocateBitmapFile, XmuReadBitmapData, 
XmuReadBitmapDataFromFile, XmuReleaseStippledPixmap. 
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—Xmu — Atom Functions ——————” XmuGetAtomName 


Name 
XmuGetAtomName — returns the property name string corresponding to the specified atom. 


Synopsis 
#include <X11/Xmu/Atoms.h> 
char *XmuGetAtomName(d, atom) 
Display *d; 
Atom atom; 


Arguments 
d Specifies a connection to an X server; returned from XOpenDisplay. 
atom Specifies the atom whose name is desired. 

Description 


XmuGetAtomName returns the property name string corresponding to the specified atom. The 
result is cached, such that subsequent requests do not cause another round-trip to the server. If 
the atom is zero, XmuGet AtomName returns “(BadAtom)”. 


Related Commands 
XmuInternAtom, XmuInternStrings, XmuMakeAtom, XmuNameofAtom. 
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XmuGetColormapAllocation \ ee 


Name 
XmuGetColormapAllocation — determine best allocation of reds, greens, and blues in a stan- 
dard colormap. 
Synopsis 


#include <X11/Xmu/StdCmap.h> 
Status XmuGetColormapAllocation(vinfo, property, red_max, 
green_max, blue_max) 
XVisualiInfo *vinfo; 
Atom property; 
unsigned long *red_max, *green_max, *blue_max; 


Arguments 
vinfo Specifies visual information for a chosen visual. 
property Specifies one of the standard colormap property names. 
red_max Returns maximum red value. 
green_max _ Returns maximum green value. 


blue_max Returns maximum blue value. 


Description 
XmuGetColormapAllocation determines the best allocation of reds, greens, and blues in 
a standard colormap. 


XmuGetColormapAllocation returns zero on failure, non-zero on success. It is assumed 
that the visual is appropriate for the colormap property. 


Related Commands 
XmuAllStandardColormaps, xmuCreateColormap, XmuDeleteStandard- 


Colormap, XmuLookupStdCmp, XmuStandardColormap, XmuVisualStandard- 
Colormaps. 
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—Xmu - System Utility Functions — XmuGetHostname 


Name 
XmuGetHostname — operating system independent routine to get machine name. 


Synopsis 
#include <X11/Xmu/SysUtil.h> 
int XmuGetHostname (buf, maxlen) 
char *buf; 
int maxlen; 


Arguments 
buf Returns the host name. 
maxlen Specifies the length of buf. 
Description 


XmuGetHostname stores the null terminated name of the local host in buf, and returns the 


length of the name. This function hides operating system differences, such as whether to call 
gethostname or uname. 
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Name 
XmulInternAtom — get an atom from the server and load it into an AtomPt r. 


Synopsis 
Atom XmuInternAtom(d, atom_ptr) 
Display *d; 
AtomPtr atom _ptr; 


Arguments 
d Specifies a connection to an X server; returned from XOpenDisplay. 


atom_ptr Specifies the AtomPt r. 


Description 
XmuInternAtom gets an atom from the server (for the string stored in AtomPtr) and stores 
the atom in the specified AtomPtr. The atom is cached such that subsequent requests do not 
cause another round-trip to the server. 


Related Commands 
XmuGetAtomName, XmuInternStrings, XmuMakeAtom, XmuNameofAtom. 
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Name , 
XmulnternStrings — get the atoms for several property name strings. 


Synopsis 
#include <X11/Xmu/Atoms.h> 
void XmuInternStrings (d, names, count, atoms) 
Display *d; 
String *names; 
Cardinal count; 
Atom *atoms; 


Arguments . 
d Specifies a connection to an X server; returned from XOpenDisplay. 
names Specifies the strings to intern. 
count Specifies the number of strings. 
atoms ~ Returns the list of Atoms value. 
Description 


XmuInternSt rings converts a list of property name strings into a list of atoms, possibly by 
querying the server. The results are cached, such that subsequent requests do not cause further 
round-trips to the server. The caller is responsible for preallocating the array of atoms. 


Related Commands 
XmuGetAtomName, XmuInternAtom, XmuMakeAtom, XmuNameofAtom. 
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XmuLocateBitmapFile N———— .Xmu - Graphics Functions — 


Name 
XmuLocateBitmapFile — creates a one-plane pixmap from a bitmap file in a standard location. 


Synopsis 
#include <X11/Xmu/Drawing.h> 
XmuLocateBitmapFile (screen, name, srcname, srcnamelen, widthp, 
heightp, xhotp, yhotp) 

Screen *screen; 
char *name; 
char *srcname; 
int srcnamelen; 
int *widthp, *heightp, *xhotp, *yhotp; 


Arguments 
name Specifies the file to read from. 
srcname Returns the full filename of the bitmap. 


srcnamelen Specifies the length of the srcname buffer. 


width Returns the width of the bitmap. 

height Returns the height of the bitmap. 

xhotp Returns the x coordinate of the hotspot. 

yhotp Returns the y coordinate of the hotspot. 
Description 


XmuLocateBitmapFile reads a file in standard bitmap file format, using XReadBitmap- 
File, and returns the created bitmap. The filename may be absolute, or relative to the global 
resource named bitmapFilePath with class BitmapFilePath. If the resource is not 
defined, the default value is the build symbol BITMAPDIR, which is typically 
/usrlinclude/X11/bitmaps. If srcnamelen is greater than zero and srcname is not NULL, the 
null terminated filename will be copied into srcname. The size and hotspot of the bitmap are 
also returned. 


Related Commands 
XmuCreatePixmapFromBitmap, XmuCreateStippledPixmap, XmuDrawLogo, 
XmuDrawRoundedRectangle, XmuFillRoundedRectangle, XmuReadBitmap- 
Data, XmuReadBitmapDataFromFile, XmuReleaseStippledPixmap. 
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# 
—Xmu — Character Set Functions Xmu Lookup 


Name 


XmuLookup* — translate a key event into a keysym and string, using various keysym sets. 
p y 


Synops 


is 


‘ 


#include <X11/Xmu/CharSet.h> 


Sate. 
int 
int 
int 
anit 
int 
int 


XmuLookupLatinl (event, 
XmuLookupLatin2 (event, 
XmuLookupLatin3 (event, 
XmuLookupLatin4 (event, 


XmuLookupKana (event, buffer, 
XmuLookupJ1ISX0201 (event, 


buffer, 
buffer, 
buffer, 
buffer, 


nbytes, 


buffer, nbytes, 


nbytes, 
nbytes, 
nbytes, 
nbytes, 


XmuLookupArabic (event, buffer, nbytes, 


keysym, 
keysym, 


keysym, 
keysym, 
keysym, 
keysym, 


keysym, 


status) 
status) 
status) 
status) 


status) 
status) 


status) 


int 
int 
INE 
serie 


XmuLookupCyrillic (event, buffer, nbytes, keysym, status) 
XmuLookupGreek (event, buffer, nbytes, keysym, status) 
XmuLookupHebrew (event, buffer, nbytes, keysym, status) 
XmuLookupAPL (event, buffer, nbytes, keysym, status) 
XKeyEvent *event; 

char *buffer; 

int nbytes; 

KeySym *keysym; 

XComposeStatus *status; 


Arguments 
event 


buffer 


Specifies the key event. 

Returns the translated characters. 
Specifies the length of the buffer. 
Returns the computed KeySym, or None. 


nbytes 
keysym 


Status Specifies or returns the compose state. 


Description 
These functions translate a key event into a keysym and string, using a keysym set other than 
Latin-1, as shown in the following table. 


a 
a 
= 
tv) 
= 
< 


Xlib Reference Manual 745 





XmuLookup* (continued) Xmu — Character Set Functions 


Function Converts To 
XmuLookupLatinl Latin-1 (ISO 8859-1), or ASCII control (Synonym 
for XLookupSt ring) 
XmuLookupLatin2 Latin-2 (ISO 8859-2), or ASCII control. 
XmuLookupLatin3 Latin-3 (ISO 8859-3), or ASCII control. 
XmuLookupLatin4 Latin-4 (ISO 8859-4), or ASCII control. 
XmuLookupKana Latin-1 (ISO 8859-1) and ASCII control in the 
Graphics Left half (values 0 to 127), and Katakana 
in the Graphics Right half (values 128 to 255), using 
the values from JIS X201-1976. 
XmuLookupJISxX0201 | JIS X0201-1976 encoding, including ASCII control. 
XmuLookupArabic Latin/Arabic (ISO 8859-6), or ASCII control. 
XmuLookupCyrillic | Latin/Cyrillic (ISO 8859-5), or ASCII control. 
XmuLookupGreek Latin/Greek (ISO 8859-7), or ASCII control. 
XmuLookupHebrew Latin/Hebrew (ISO 8859-8), or ASCII control string. 
XmuLookupAPL APL string 





XmuLookupLatin1 is identical to XLookupSt ring, and exists only for naming symmetry 
with other functions covered on this page. 


Related Commands 
XmuCompareISOLatinl, XmuCopyISOLatinlLowered, XmuCopyISOLatin1- 
Uppered. 
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—Xmu - CloseDisplay Hook J} — XmuLookupCloseDisplayHook 


Name . 
XmuLookupCloseDisplayHook — get currently registered close display callback function. 


Synopsis 
#include <X11/Xmu/CloseHook.h> 
Bool XmuLookupCloseDisplayHook (display, handle, func, arg) 
Display *display; 
CloseHook handle; 
int (*func) (); 
caddr_ t arg; 


Arguments 
isplay Specifies a connection to an X server; returned from XOpenDisplay. 
handle Specifies the callback by ID, or NULL. 
func — Specifies the callback by function. 
arg Specifies the function data to match. 
Description 


XmuLookupCloseDisplayHook determines if a callback is registered. If handle is not 
NULL, it specifies the callback to look for, and the func and arg parameters are ignored. If 
handle is NULL, the function will look for any callback that matches the specified func and 
arg. This function returns True if a matching callback exists, or otherwise False. 


Related Commands 
XmuAddCloseDisplayHook, XmuRemoveCloseDisplayHook. 
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XmuLookupStandardColormap Kini Gtaadancucoiertnaps 


Name 
XmuLookupStandardColormap — create a standard colormap if not already created. 


Synopsis 
#include <X11/Xmu/StdCmap.h> 
XmuLookupStandardColormap (display, screen, visualid, depth, 
property, replace, retain) 
Display *display; 
int screen; 
' VisualID visualid; 
unsigned int depth; 
Atom property; 
Bool replace; 
Bool retain; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
screen Specifies the screen of the display. 


visualid Specifies the visual type. 


depth Specifies the visual depth. 

property Specifies the standard colormap property. 

replace Specifies whether or not to replace. 

retain Specifies whether or not to retain. 
Description 


XmuLookupStandardColormap creates a standard colormap if one does not currently 
exist, or replaces the currently existing standard colormap. 


Given a screen, a visual, and a property, this function will determine the best allocation for the 
property under the specified visual, and determine whether to create a new colormap or to use 
the default colormap of the screen. 


If replace is True, any previous definition of the property will be replaced. If retain is 
True, the property and the colormap will be made permanent for the duration of the server ses- 
sion. However, pre-existing property definitions which are not replaced cannot be made perma- 
nent by a call to this function; a request to retain resources pertains to newly created resources. 


XmuLookupStandardColormap returns zero on failure, non-zero on success. A request to 
create a standard colormap upon a visual which cannot support such a map is considered a fail- 
ure. An example of this would be requesting any standard colormap property on a mono- 
chrome visual, or, requesting an RGB_BEST_MAP on a display whose colormap size is 16. 
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Xmu — Standard Colormaps (continued) XmuLookupStandardColormap 


Related Commands 
XmuAl11StandardColormaps, XmuCreateColormap, 
Colormap, XmuGetColormapAllocation, XmuStandardColormap, XmuVisual- 


XmuDeleteStandard- 


StandardColormaps. 
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XmuMakeAtom Xmu — Atom Functions— 


Name 
XmuMakeAtom — create At omPt r to hold atom list for a property name string. 


Synopsis 
#include <X11/Xmu/Atoms.h> 
AtomPtr XmuMakeAtom (name) 
char* name; 


Arguments 
name Specifies the atom name. 


Description 
XmuMakeAt om creates and initializes an AtomPt r, which is an opaque object that contains a 
property name string and a list of atoms for that string—one for each display. XmuIntern- 
Atom is used to fill in the atom for each display. 


Related Commands 
XmuGetAtomName, XmuInternAtom, XmuInternStrings, XmuNameofAtom. 
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— Xmu — Atom Functions —————_ XmuNameOfAtom 


Name 
XmuNameOfAtom — return property name string represented by an AtomPtr. 


Synopsis 
#include <X11/Xmu/Atoms.h> 
char *XmuNameOfAtom(atom_ptr) 
AtomPtr atom_ptr; 


Arguments 2 
atom_ptr Specifies the AtomPtr. 


Description 
XmuNameOfAtom returns the property name string represented by the specified AtomPtr. 


Related Commands 
XmuGetAtomName, XmuInternAtom, XmuInternStrings, XmuMakeAtom. 
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XmuPrintDefaultErrorMessage sy ccakeesiea nese eae 


Name 
XmuPrintDefaultErrorMessage — print the standard protocol error message. 


Synopsis 
#include <X11/Xmu/Error.h> 
int XmuPrintDefaultErrorMessage (display, event, fp) 
Display *display; 
XErrorEvent *event; 


FILE *fp; 
Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
event Specifies the error event whose contents will be printed. 
fp Specifies where to print the error message. 
Description 


XmuPrintDefaultErrorMessage prints an error message, equivalent to Xlib’s default 
error message for protocol errors. It returns a non-zero value if the caller should consider exit- 
ing, otherwise it returns zero. This function can be used when you need to write your own error 
handler, but need to print out an error from within that handler. 


Related Commands 
XmuSimpleErrorHandler. 
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— Xmu - Graphics Functions ———— XmuRead BitmapData 


Name 


Synopsis 


XmuReadBitmapData — read and check bitmap data from any stream source. 


#include <X11/Xmu/Drawing.h> 
int XmuReadBitmapData(fstream, width, height, datap, 
y_hot) 
FILE *fstream; 
unsigned int *width, *height; 
unsigned char **datap; 
emt *x hot, *y hot; 


Arguments 
stream 


width 
height 
datap 
x_hot 
y_hot 


Description 


Specifies the stream to read from. 
Returns the width of the bitmap. 
Returns the height of the bitmap. 
Returns the parsed bitmap data. 
Returns the x coordinate of the hotspot. 
Returns the y coordinate of the hotspot. 


x hot, 


XmuReadBitmapData reads a standard bitmap file description from the specified stream, and 
returns the parsed data in a format suitable for passing to XCreatePixmapFromBitmap- 
Data. The return value of the function has the same meaning as the return value for XRead- 


BitmapFile. 


XmuReadBitmapData is equivalent to XReadBitmapFile, except that this routine 
processes any type of stream input, and it does not create a pixmap containing the resulting 
data. This is useful when you want to create a multi-plane pixmap from the data, and don’t 
want to create an intermediate one-plane pixmap. 


Related Commands 
XmuCreatePixmapFromBitmap, XmuCreateStippledPixmap, 
XmuDrawRoundedRectangle, XmuFillRoundedRectangle, XmuLocateBitmap- 
File, XmuReadBitmapDataFromFile, XmuReleaseStippledPixmap. 


Xlib Reference Manual 


xmuDrawLogo, 


753 


im 
a 
= 
i) 
= 
aS 


tt 





XmuReadBitmapDataFromFile ‘Xion Graph pacectione— 


Name 
XmuReadBitmapDataFromFile — read and check bitmap data from a file. 


Synopsis 
#include <X11/Xmu/Drawing.h> 
int XmuReadBitmapDataFromFile (filename, width, height, datap, 
x_hot, y_hot) 

char *filename; 
unsigned int *width, *height; 
unsigned char **datap; 
gatenx hot, *y hot; 


Arguments 
filename Specifies the file to read from. © 
width Returns the width of the bitmap. 
height Returns the height of the bitmap. 
datap Returns the parsed bitmap data. 
x_hot Returns the x coordinate of the hotspot. 
y_hot Returns the y coordinate of the hotspot. 
Description 


XmuReadBitmapDataFromFile reads a standard bitmap file description from the specified 
file, and returns the parsed data in a format suitable for passing to XCreatePixmapF rom- 
BitmapData. The return value of the function has the same meaning as the return value for 
XReadBitmapFile. 


Unlike XReadBitmapFile, this function does not create a pixmap. This function is useful 
when you want to create a multi-plane pixmap without creating an intermediate one-plane pix- 
map. 


Related Commands 
XmuCreatePixmapFromBitmap, XmuCreateStippledPixmap, XmuDrawLogo, 
XmuDrawRoundedRectangle, XmuFillRoundedRectangle, XmuLocateBitmap- 
File, XmuReadBitmapData, XmuReleaseStippledPixmap. 
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pal atepiiice Rorenenk ) XmuReleaseStippledPixmap 


Name 
XmuReleaseStippledPixmap — release pixmap created with XmuCreateStippled- 
Pixmap. 
Synopsis 


#include <X11/Xmu/Drawing.h> 

void XmuReleaseStippledPixmap (screen, pixmap) 
Screen *screen; 
Pixmap pixmap; 


Arguments 
screen Specifies the screen the pixmap was created on. 
pixmap Specifies the pixmap to free. 

Description 


XmuReleaseStippledPixmap frees a pixmap created with XmuCreateStippled- 
Pixmap, to maintain correct cache reference counts. 


Related Commands 


XmuCreatePixmapFromBitmap, XmuCreateStippledPixmap, XmuDrawLogo, 
XmuDrawRoundedRectangle, XmuFillRoundedRectangle, XmuLocateBitmap- 
File, XmuReadBitmapData, XmuReadBitmapDataFromFile. 
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XmuRemoveCloseDisplayHook  \ en cea unnitiee 


Name 
XmuRemoveCloseDisplayHook — remove registered close display callback function. 


Synopsis 
#include <X11/Xmu/CloseHook.h> 
Bool XmuRemoveCloseDisplayHook (display, handle, func, arg) 
Display *display; 
CloseHook handle; 
int (*func) () > 
caddr t arg; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
handle Specifies the callback by ID, or NULL. 
func Specifies the callback by function. 
arg Specifies the function data to match. 
Description 


XmuRemoveCloseDisplayHook unregisters a callback that has been registered with Xmu- 
AddCloseDisplayHook. If handle is not NULL, it specifies the ID of the callback to 
remove, and the func and arg parameters are ignored. If handle is NULL, the first callback 
found to match the specified func and arg will be removed. Returns True if a callback was 
removed, else returns False. 


Related Commands 
XmuAddCloseDisplayHook, XmuLookupCloseDisplayHook. 
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— Xmu —- Window Utility Functions —— XmuScreenOfWindow 


Name ‘ 
XmuScreenOfWindow — returns a pointer to the Screen structure for the specified window. 


Synopsis 
#include <X11/Xmu/WinUtil.h> 
Screen *XmuScreenOfWindow (display, w) 
Display *display; 
Window w; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
Ww Specifies the window. 

Description 


XmuScreenOfWindow retums a pointer to the Screen structure that describes the screen on 
which the specified window was created. 


Related Commands 
XmuClientWindow, XmuUpdateMapHints. 
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XmuSimpleErrorHandler \“— Xmu - Error Handler Functions— 


Name 
XmuSimpleErrorHandler — an error handler that ignores certain errors. 


Synopsis 
#include <X11/Xmu/Error.h> 
int XmuSimpleErrorHandler (display, error) 
Display *display; 
XErrorEvent *error; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
error Specifies the error event. 

Description 


XmuSimpleErrorHandler ignores BadWindow errors for XQueryTree and XGet- 
WindowAttributes, and ignores BadDrawable errors for XGetGeomet ry; it returns 
zero in those cases. Otherwise, it prints the default error message, and returns a non-zero value 
if the caller should consider exiting, and zero if the caller should not exit. 


Related Commands 
XmuPrintDefaultErrorMessage. 
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ipa Saaasle Conetbe } XmuStandardColormap 


Name ‘ 
XmuStandardColormap — create one standard colormap. 


Synopsis 
#include <X11/Xmu/StdCmap.h> 
XmuStandardColormap (display, screen, visualid, depth, property, 
cmap, red_max, green_max, blue_max) 
Display display; 
int screen; 
VisualID visualid; 
unsigned int depth; 
Atom property; 
Colormap cmap; 
unsigned long red_max, green_max, blue_max; 


Arguments 
display Specifies a connection to an X server; retumed from XOpenDisplay. 
screen Specifies the screen of the display. 
visualid Specifies the visual type. 
depth Specifies the visual depth. 
property Specifies the standard colormap property. 
cmap Specifies the colormap ID, or None. 
red_max Specifies the red allocation. 


green_max Specifies the green allocation. 
blue_max Specifies the blue allocation. 


Description 
XmuStandardColormap creates one standard colormap for the given screen, visualid, and 
visual depth, with the given red, green, and blue maximum values, with the given standard 
property name. Upon success, it returns a pointer to an XStandardColormap Structure 
which describes the newly created colormap. Upon failure, it returns NULL. If cmap is the 
default cclormap of the screen, the standard colormap will be defined on the default colormap; 
otherwise a new colormap is created. 


Resources created by this function are not made permanent; that is the caller’s responsibility. 
Related Commands 
XmuAl1StandardColormaps, XmuCreat eColormap, XmuDeleteStandard- 


Colormap, XmuGetColormapAllocation, XmuLookupStdCmp, XmuVisual- 
StandardColormaps. 
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XmuUpdateMapHints Xmu — Window Utility Functions — 


Name 
XmuUpdateMapHints — set WM_HINTS flags to USSize and USPosition. 


Synopsis 
#include <X11/Xmu/WinUtil.h> 
Bool XmuUpdateMapHints (display, w, hints) 
Display *display; 
Window w; 
XSizeHints *hints; 


Arguments 


display Specifies .a connection to an X server; returned from XOpenDisplay. 
win Specifies the window. 
hints Specifies the new hints, or NULL. 

Description 


XmuUpdateMapHints Clears the PPosition and PSize flags and sets the USPosition 
and USSize flags in the hints structure, and then stores the hints for the window using XSet — 
WMNormalHints and returns True. If NULL is passed for the hints structure, then the current 
hints are read back from the window using XGetWMNormalHints the flags are set as 
described above, the property is reset, and True is returned. XmuUpdateMapHints returns 
False if it was unable to allocate memory or, when NULL is passed, if the existing hints could 
not be read. 


Related Commands 
XmuClientWindow, XmuScreenOfWindow. 
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Eee ert dacaiceinnane J XmuVisualStandardColormaps 


Name : 
XmuVisualStandardColormaps — create all standard colormaps for given visual and screen. 


Synopsis 
#include <X11/Xmu/StdCmap.h> 
XmuVisualStandardColormaps (display, screen, visualid, depth, 
replace, retain) 

Display *display; 
int screen; 
VisualID visualid; 
unsigned int depth; 
Bool replace; 
Bool retain; 


Arguments 
display Specifies a connection to an X server; returned from XOpenDisplay. 
screen Specifies the screen of the display. 


visualid Specifies the visual type. 


depth Specifies the visual depth. 

replace Specifies whether or not to replace the standard colormap property. 

retain Specifies whether or not to retain the colormap resource permanently. 
Description 


XmuVisualStandardColormaps creates all of the appropriate standard colormaps for a 
given visual on a given screen, and optionally redefines the corresponding standard colormap 
properties. 


If replace is True, any previous definition will be removed. If retain is True, new pro- 
perties will be retained for the duration of the server session. This function returns zero on fail- 
ure, non-zero on success. On failure, no new properties will be defined, but old ones may have 
been removed if replace was True. 


Not all standard colormaps are meaningful to all visual classes. This routine will check and 
define the following properties for the following classes, provided that the size of the colormap 
is not too small. For DirectColor and PseudoColor: RGB DEFAULT MAP, 
RGB_BEST MAP, RGB RED MAP, RGB GREEN MAP, RGB BLUE MAP, and RGB GRAY MAP. For 
TrueColor and StaticColor: RGB BEST MAP. For GrayScaleand StaticGray: 
RGB_GRAY MAP. 


Related Commands 
XmuAll1StandardColormaps, XmuCreateColormap, XmuDeleteStandard- 
Colormap, XmuGetColormapAllocation, XmuLookupStdCmp, XmuStandard- 
Colormap. 
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line_style Ne onncl LineOnOffDash LineDoubleDash 





cap_style 


CapButt CapRound CapProjecting 




















join_style 





JoinMiter 


C2 JoinRound JoinBevel 








fill _ style 


Tile GC foreground 





GC background Undrawn Pixels [<] 





Boleks Ove FillTiled FillStippled FillOpaqueStippled 


< - 


Stipple 
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Outline of polygon to fill EvenOddRule WindingRule 


arc_mode 





ArcChord ArcPieSlice 








subwindow_ mode 


IncludeInferiors Graphics drawn with this setting will appear through all mapped 
subwindows, but not through siblings. 


ClipByChildren Graphics drawn will not draw through any other window that has 
a background. 


graphics exposures 


True Generate GraphicsExpose Of NoExpose events when XCopyArea or 
XCopyP lane is called with this GC. 


False Don't generate GraphicsExpose Or NoExpose events. 
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At-a-glance 


About the Editor 


Adrian Nye is a senior technical writer at O’Reilly and Associates. In addition 
to the X Window System programming manuals, he has written user’s manuals 
for data acquisition products, and customized UNIX documentation for Sun 
Microsystems and Prime. Adrian has also worked as a programmer writing 
educational software in C, and as a mechanical engineer designing offshore oil- 
spill cleanup equipment. He has long-term interests in using his technical 
writing skills to promote recycling and other environmentally-sound 
technologies. He graduated from the Massachusetts Institute of Technology in 
1984 with a B.S. in Mechanical Engineering. 
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This book provides a complete reference to the X library, which is the lowest 
level of programming interface to X. It provides: 


@ Reference pages for each Xlib function 

@ A permuted index to the Xlib functions 

@ Reference pages for each event type 

@ Description of macros 

@ A listing of the standard color name database 

@ Alphabetical index and description of structures 
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@ Single-page reference aids for the GC and window attributes 


The Xlib Programming Manual and Xlib Reference Manual have been licensed and 
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Masscomp and Motorola. Other companies, including Intergraph, Sequent, 


Pyramid, and Graphics Software Systems, are planning to ship the generic version 
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